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 |