API du catalogue
Pour les développeurs
L'API externe fournit le catalogue RusLit - époques, auteurs et fiches des œuvres en cinq langues - aux bibliothèques, écoles, services éducatifs et de référence. L'accès est ouvert sur demande, après examen par un administrateur.
Ce que fournit l'API
- Époques : noms, années et descriptions.
- Auteurs : noms, années de vie et biographies.
- Œuvres : titres, résumés, histoire de la création, contexte et faits intéressants.
- Table des matières : numéros et titres des chapitres.
- Couvertures en deux tailles (WebP et JPEG) avec leur source et leur licence.
- Tous les textes des fiches en cinq langues à la fois - russe, anglais, français, espagnol et chinois - et les liens vers les pages du site.
- Une date de modification pour chaque entrée et un filtre updatedSince pour ne récupérer que les changements.
Les textes des chapitres ne sont pas fournis par l'API : les œuvres se lisent uniquement sur le site. Chaque fiche contient des liens vers les pages du site.
Comment obtenir l'accès
- Inscrivez-vous sur le site et confirmez votre adresse e-mail.
- Déposez une demande dans « Mes applications » : décrivez l'application et choisissez un niveau de limites.
- Un administrateur examine la demande et vous recevez la décision par e-mail. La première approbation ouvre l'accès pour 6 mois.
- Créez le secret de l'application. Il n'est affiché qu'une fois - conservez-le en lieu sûr.
- Obtenez un jeton via OAuth 2.0 (client credentials) et envoyez-le dans l'en-tête Authorization. Un jeton est valable une heure.
- Un rappel est envoyé 30 et 7 jours avant la fin de l'accès. Une prolongation ajoute 12 mois.
Niveaux de limites
| Niveau | Requêtes par minute | Requêtes par jour |
|---|---|---|
| De base pour la plupart des applications | 60 | 10 000 |
| Étendu pour les grands catalogues et la synchronisation fréquente | 600 | 200 000 |
Les limites s'appliquent par application. En cas de dépassement, l'API répond 429 avec l'en-tête Retry-After.
Règles principales
- Citez la source : « RusLit » avec un lien vers la page de l'œuvre sur le site.
- N'essayez pas de récupérer automatiquement les textes des chapitres sur le site - les conditions l'interdisent.
- Conservez les données chez vous et mettez-les à jour avec updatedSince au lieu de demander tout le catalogue à chaque fois.
- La version v1 ne reçoit que des ajouts. Les changements incompatibles arriveront dans la v2, et la v1 fonctionnera encore au moins 6 mois après.
Conditions d'utilisation de l'API · Comment nous traitons les données des partenaires