La déclaration de la vente d'une publication pour des fins de prêt est très semblable à la procédure de vente de produits pour le grand public, décrite dans . Vous pouvez donc vous référer à cette documentation, en prenant soin de tenir compte des quelques paramètres suivants, dont l'utilisation diffère.
|
Nom |
Obligatoire |
Description |
|---|---|---|
|
|
Oui |
Identifiant du produit bibliothèque reçu dans le flux ONIX (et non l'ISBN/EAN du produit grand public). |
|
|
Non |
Contrairement à l'API de vente pour produits grand public, le paramètre |
|
|
Non |
Ce paramètre est désuet; il n'est plus requis pour la vente de produits bibliothèques. |
|
|
Oui |
Indique sous quel format les informations sur le lien de prêt seront retournées. Valeurs possibles: |
Dans le cas de la vente d'un produit bibliothèque, un lien, qui permet de déclarer un prêt sur cet exemplaire, vous est retourné, soit en XML ou en JSON (voir le paramètre output ci-dessus). Ce lien doit être conservé dans votre système (libraire), et doit être transmis au système de prêt qu'utilise la bibliothèque qui a fait l'achat du livre (référez-vous aux spécifications du système de prêt pour cette étape). Il s'agit d'un lien pérenne.
La réponse prend la forme suivante:
|
Format |
Réponse |
|---|---|
|
|
|
|
|
|
Le lien [loan_url] prend la forme suivante:
https://domaine/api/loans/UGV60GNogpXRcS3UtHAkZcHPOlDTIlnaJ3Z1uFYuf0DQfmgAEnzSUdY3rQY1vRxI/activate
Les mêmes codes HTTP de retour que pour l'API de vente pour les produits grand public s'appliquent, en plus du suivant:
|
Code |
Contenu |
Description |
|---|---|---|
|
400 |
|
La publication ne peut pas être prêtée. |