Aller au contenu

Où regarder ou lire

GET/v1/works/{id}/availability

Renvoie les plateformes légales qui proposent une œuvre, dans le monde entier et dans les pays demandés.

Requête

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

Paramètres

  • id

    cheminobligatoire

    Identifiant de l’élément, un UUID.

    texte

  • countries

    requêtefacultatif

    Jusqu’à cinq codes de pays à deux lettres, séparés par des virgules, pour lesquels obtenir les plateformes régionales.

    texte

Réponse

Une requête réussie répond 200 avec ce JSON :

  • countriesliste de texte
  • regionalobjetpeut être null
    • countrytexte
    • sourceUrltexte (uri)
    • verifiedAttexte (date-time)
    • platformsliste de objet
      • nametexte
      • kindtexte
        Valeurs autoriséesstreamreadpurchase
      • offertexte
        Valeurs autoriséessubscriptionfreeadsbuyrentunknown
  • globalliste de objet
    • nametexte
    • kindtexte
      Valeurs autoriséesstreamreadpurchase
    • urltexte (uri)

Erreurs

Comme toutes les opérations, celle-ci peut répondre 400 en cas de paramètres invalides, 404 lorsque rien n’est trouvé et 429 lorsque vous envoyez trop de requêtes. Toutes les erreurs partagent la même forme.

En savoir plus sur les erreurs