/collection/items/{id}/codes/checkWhat a code names, compared with this copy: the copy itself, another issue or edition to change the copy to, or nothing the catalog knows yet. Changes nothing. 120 checks an hour.
collector.checkCopyCode()collection:readX-Request-Ididstring (uuid)requiredobject
textstringrequired1–60 characters
addOnstring or nullat most 5 characters
formatstring or nullat most 20 characters
kindenum or nullupcisbnissndistributornotestring or nullat most 1000 characters
200OKWhat the code names.
object
codeobjectrequiredkindenumrequiredupcisbnissndistributorcodestringrequiredaddonstringrequireddisplaystringrequiredhintsarray of stringrequiredWhat the code itself says (the add-on’s cover and printing...).
currentbooleanrequiredThe copy already is what the code names, or already has the code.
What the code names.
Weaker: the code’s series at the copy’s number.
The code, when it’s already on this copy.
invalid_requestinvalid_jsoninvalid_code
invalid_request: The query or body doesn’t match the schema (see errors[]).
invalid_json: The body isn’t JSON.
invalid_code: Not a valid barcode, ISBN, ISSN or code (check digits).
unauthorized: Not signed in (no session or token, or an expired one).
not_found: Nothing at that address.
payload_too_large: The body is over 1,048,576 bytes, this operation’s limit.
rate_limitedtemporarily_blocked
rate_limited: Over the caller’s limit: the per-minute burst or the per-day quota (RateLimit headers; wait Retry-After seconds).
temporarily_blocked: Too many refused requests in a row: blocked for a while (Retry-After says how long).
internal: Something went wrong on our side (quote the requestId).