Los datos de Philotopie
Las fichas de Philotopie se leen en JSON, sin clave ni registro, bajo licencia CC BY-SA 4.0. Qué da la API y con qué condiciones.
Las fichas del sitio se leen en JSON, sin clave y sin registro. Puede consultarlas, redifundirlas y construir sobre ellas, con la condición de citar a Philotopie y de compartir en las mismas condiciones.
La API sirve el fondo francés, que es el fondo de referencia del sitio.
Qué da la API
Cinco clases de fichas, en su estado publicado. Los esbozos quedan fuera: el sitio crea automáticamente una ficha vacía cuando una ficha publicada cita a otra, y esas cáscaras no tienen nada que decir.
Las direcciones son:
/api/public/entities/philosophes/api/public/entities/oeuvres/api/public/entities/concepts/api/public/entities/courants/api/public/entities/lieux
Consultar una lista
Una lista se recorre página por página. page empieza en 1 y par_page vale 50 por defecto, 100 como máximo.
`` GET https://philotopie.fr/api/public/entities/philosophes?page=2&par_page=25 ``
La respuesta lleva la licencia, el tipo solicitado, la paginación y las fichas. Una propiedad ausente de la base está ausente de la respuesta: no hay ni cadenas vacías ni fechas inventadas.
`` { "licence": { "nom": "CC BY-SA 4.0", "attribution": "Philotopie - https://philotopie.fr" }, "type": "philosophes", "pagination": { "page": 2, "par_page": 25, "total": 217, "pages": 9 }, "donnees": [ { "slug": "spinoza", "nom": "Baruch Spinoza", ... } ] } ``
Consultar una ficha
El detalle de una ficha añade sus vínculos: los conceptos que un filósofo trabaja, las obras que ha escrito, las corrientes a las que se adscribe. Cada uno viene con su slug y con la dirección de su propia ficha.
Una clave que lleva el nombre de un hecho sirve solo ese hecho. auteurs dice quién escribió la obra, y oeuvres lo que un filósofo ha escrito, nada más. Los demás vínculos entre un filósofo y un libro viven al lado, bajo philosopheslies y oeuvresliees, y cada uno dice su naturaleza: traductor, editor, interlocutor, crítico, influencia, mención.
`` GET https://philotopie.fr/api/public/entities/philosophes/spinoza ``
Condiciones de uso
Sin autenticación y sin cuota. La API se sirve con una cabecera Access-Control-Allow-Origin: *, de modo que es utilizable desde un navegador, y con una caché de una hora. Solo le pedimos que no la martillee: los datos cambian de un día para otro, no de un segundo para otro.
Atribución. El contenido se publica bajo CC BY-SA 4.0. Si lo reutiliza, cite a Philotopie con un enlace a la ficha y a la licencia, señale sus modificaciones y comparta su trabajo derivado bajo la misma licencia.
Qué no da la API
- El cuerpo largo de las fichas: biografías, análisis y definiciones
extensas se quedan en el sitio, donde están revisados y compuestos.
- Las fichas no publicadas.
- Las imágenes en sí: la respuesta da su dirección, y la imagen sigue
sujeta a su propio crédito, indicado en la ficha.
- Toda escritura: la API es de solo lectura.
Una pregunta, un uso que señalar
Si construye algo con estos datos, nos interesa saberlo, y estamos dispuestos a hacer evolucionar la API si le falta algo. Escríbanos a contact@philotopie.fr.