Zum Inhalt springen

Wo schauen oder lesen

GET/v1/works/{id}/availability

Liefert die legalen Plattformen, die ein Werk anbieten, weltweit und in den angefragten Ländern.

Anfrage

Shell
curl "https://api.nogitsu.com/v1/works/01a0cb02-0a14-7877-911d-5b4dde76df72/availability"

Parameter

  • id

    Pfaderforderlich

    ID des Elements, eine UUID.

    Text

  • countries

    Queryoptional

    Bis zu fünf zweibuchstabige Ländercodes, durch Kommas getrennt, für die regionale Plattformen geliefert werden sollen.

    Text

Antwort

Eine erfolgreiche Anfrage antwortet mit 200 und diesem JSON:

  • countriesListe von Text
  • regionalObjektkann null sein
    • countryText
    • sourceUrlText (uri)
    • verifiedAtText (date-time)
    • platformsListe von Objekt
      • nameText
      • kindText
        Erlaubte Wertestreamreadpurchase
      • offerText
        Erlaubte Wertesubscriptionfreeadsbuyrentunknown
  • globalListe von Objekt
    • nameText
    • kindText
      Erlaubte Wertestreamreadpurchase
    • urlText (uri)

Fehler

Wie jede Operation kann auch diese mit 400 bei ungültigen Parametern antworten, mit 404, wenn nichts gefunden wird, und mit 429, wenn du zu viele Anfragen sendest. Alle Fehler haben dieselbe Form.

Mehr über Fehler