A referência da API está disponível somente em inglês.
Titles{titleRef}sources
GET/v1/ titles/ {titleRef}/ sources
Where a title is held, confirmed now: the institution, the page address and the formats it lists. The one endpoint that spends a verification.
Parâmetros
- titleRefstring · no caminhoobrigatório
A public id (
mv_,sr_,sn_,ep_) or the catalog UUID.Mais
A public id (
mv_,sr_,sn_orep_) or the catalog UUID.
Campos da resposta
- idstring
- sourcesSource[]
- checked_atstring · date-time
When this answer was compiled - the only staleness signal published, and deliberately the only one.
- unverifiedinteger
How many locations were WITHHELD because we could not confirm them. A count of what we could not stand behind, and nothing more.
Cabeçalhos de resposta
- X-Request-ID
The id of this request, on every response - success or error. Quote it to support: it is how we find your request in our logs. An
X-Request-IDyou send is honoured and echoed back, so you can use your own; otherwise we generate one./v1error bodies carry no trace id of their own. - X-Quota-Reset
RFC 3339 instant at which the billing period rolls. Present on every response to a request whose key was metered - every 2xx, every error a handler returned, and the quota 429. Absent on a refusal that happens before metering: a missing or unknown key (401), a restricted key or a plan that does not carry the endpoint (403), a public demo-key gate refusal, and the pre-authentication flood throttle.
- X-Calls-Remaining
Requests left in the period after this one, never below 0. Present whenever
X-Quota-Resetis (see there for when a response carries no quota headers). - X-Verifications-Remaining
How many verifications you can still make before a limit stops you. The daily limit and the monthly allowance are counted separately; this is whichever of the two runs out first. Sent whenever
X-Quota-Resetis. - X-Quota-Grace
truewhen THIS request fell inside the 10% grace band above a monthly ceiling. A grace request is served and is not billed; treattrueas "back off now", not as headroom. Alwaystrueorfalse, never absent when the other quota headers are present. - Retry-After429
Seconds to wait before retrying. On every 429 - the quota hard stop, the public demo key's limits, and the pre-authentication flood throttle (which carries this header alone, because no key has been read yet).
- X-Demo-Challenge-ModeSomente com a chave de demonstração
Sent only on responses to the public demo key. The value
interactiveasks the documentation page to show the visible verification widget - it is sent once a browser has made more than five runs in ten minutes or has received a 429. The page then repeats the header,X-Demo-Challenge-Mode: interactive, on its next request, with the widget's token inX-Demo-Challenge. Requests made with your own key never receive it.
Erros
Detalhes
The one endpoint that spends a verification: every request spends exactly one, whether we check again or already hold the answer. We confirm where a title is held and return the institution, the page address, the formats it lists and the moment we checked. Every other endpoint counts only against your plan's request allowance.