Para desarrolladores

Qué ofrece la API

• Épocas: nombres, años y descripciones.
• Autores: nombres, años de vida y biografías.
• Obras: títulos, resúmenes, historia de la creación, contexto y datos curiosos.
• Índice: números y títulos de los capítulos.
• Portadas en dos tamaños (WebP y JPEG) con su fuente y licencia.
• Todos los textos de las fichas en cinco idiomas a la vez - ruso, inglés, francés, español y chino - y enlaces a las páginas del sitio.
• Una fecha de modificación en cada registro y un filtro updatedSince para obtener solo los cambios.

La API no ofrece los textos de los capítulos: las obras solo se leen en el sitio. Cada ficha incluye enlaces a las páginas del sitio.

Cómo obtener acceso

1. Regístrese en el sitio y confirme su correo electrónico.
2. Envíe una solicitud en «Mis aplicaciones»: describa la aplicación y elija un nivel de límites.
3. Un administrador revisa la solicitud y recibirá la decisión por correo. La primera aprobación abre el acceso durante 6 meses.
4. Cree el secreto de la aplicación. Solo se muestra una vez: guárdelo en un lugar seguro.
5. Obtenga un token mediante OAuth 2.0 (client credentials) y envíelo en la cabecera Authorization. El token es válido una hora.
6. Recibirá un aviso 30 y 7 días antes de que termine el acceso. Una prórroga añade 12 meses.

Niveles de límites

Los límites se aplican por aplicación. Al superarlos, la API responde 429 con la cabecera Retry-After.

Reglas principales

• Cite la fuente: «RusLit» con un enlace a la página de la obra en el sitio.
• No intente obtener automáticamente los textos de los capítulos del sitio: las condiciones lo prohíben.
• Guarde los datos en su sistema y actualícelos con updatedSince en lugar de pedir todo el catálogo cada vez.
• La versión v1 solo recibe añadidos. Los cambios incompatibles llegarán en la v2, y la v1 seguirá funcionando al menos 6 meses más.

Condiciones de uso de la API · Cómo tratamos los datos de los socios