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 Outils d'intégration de contenus pour les libraires. 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 |
|---|
isbn | Oui | Identifiant du produit bibliothèque reçu dans le flux ONIX (et non l'ISBN/EAN du produit grand public). |
protection | Non | Contrairement à l'API de vente pour produits grand public, le paramètre protection n'est pas requis pour vendre un produit bibliothèque. La protection Adobe chronodégradable sera automatiquement appliquée à chaque prêt. |
loan | Non | Ce paramètre est désuet; il n'est plus requis pour la vente de produits bibliothèques. |
output | Oui | Indique sous quel format les informations sur le lien de prêt seront retournées. Valeurs possibles: xml, json. |
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 |
|---|
XML | <?xml version="1.0" encoding="UTF-8"?>
<sale> <loan-url>[loan_url]</loan-url>
<status>created</status>
</sale>
</xml>
|
json | {"loan_url":"[loan_url]","status":"created"} |
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 | cannot_loan | La publication ne peut pas être prêtée. |