Librarika Hubfor developers Test environment
Menu

Reference

Problem codes

Every error of the Librarika API (/lms/v1) is an RFC 9457 problem (application/problem+json) whose code is one of the codes below. Its type is the URI of the code's page, https://api.librarika.dev.raynux.com/problems/<code>. Codes are stable: new ones are added within v1, none is removed or changes meaning. Treat a code you do not know by its HTTP status. See Errors.

This page and the code pages are generated from the API's problem catalogue (make docs-problems).

Authentication and access

Code Status
branch_access_denied 403 Forbidden
credential_suspended 403 Forbidden
dpop_invalid 401 Unauthorized
feature_disabled 403 Forbidden
forbidden 403 Forbidden
insufficient_scope 403 Forbidden
invalid_token 401 Unauthorized
ip_not_allowed 403 Forbidden
library_not_enabled 403 Forbidden
library_suspended 403 Forbidden
member_access_required 403 Forbidden
token_expired 401 Unauthorized
wrong_flow 403 Forbidden

The request itself

Code Status
bad_request 400 Bad Request
credential_in_url 400 Bad Request
idempotency_key_required 400 Bad Request
idempotency_key_reused 422 Unprocessable Entity
invalid_cursor 400 Bad Request
method_not_allowed 405 Method Not Allowed
not_acceptable 406 Not Acceptable
not_found 404 Not Found
page_too_deep 400 Bad Request
payload_too_large 413 Request Entity Too Large
precondition_failed 412 Precondition Failed
precondition_required 428 Precondition Required
unsupported_media_type 415 Unsupported Media Type
validation_failed 422 Unprocessable Entity

Conflicts with the resource's current state (409)

Code Status
account_linked_in_institute 409 Conflict
already_checked_out 409 Conflict
already_on_hold 409 Conflict
email_taken 409 Conflict
hold_not_cancellable 409 Conflict
idempotency_in_progress 409 Conflict
member_already_linked 409 Conflict
member_banned 409 Conflict
member_no_taken 409 Conflict

Refusals under a library rule (422)

Code Status
copy_not_holdable 422 Unprocessable Entity
email_required_for_login answered as 422 validation_failed, field error on /email
hold_invalid_copy answered as 422 validation_failed, field error on the item key sent (/media_copy_id or /accessor_no)
hold_limit_reached 422 Unprocessable Entity
hold_member_type_not_allowed 422 Unprocessable Entity
item_not_circulating 422 Unprocessable Entity
member_inactive 422 Unprocessable Entity
member_not_found answered as 422 validation_failed, field error on /member_id (or /member_no)
member_quota_reached 422 Unprocessable Entity
no_holdable_copies 422 Unprocessable Entity
rule_violation 422 Unprocessable Entity
title_not_holdable 422 Unprocessable Entity

Rate limits

Code Status
daily_quota_exceeded 429 Too Many Requests
rate_limit_unavailable 503 Service Unavailable
rate_limited 429 Too Many Requests

Server side

Code Status
auth_unavailable 503 Service Unavailable
internal_error 500 Internal Server Error
not_implemented 501 Not Implemented
search_unavailable 503 Service Unavailable