Les données de Philotopie
Les fiches du site sont lisibles en JSON, sans clé et sans inscription. Vous pouvez les interroger, les rediffuser et construire dessus, à la condition de citer Philotopie et de partager aux mêmes conditions.
Ce que l'API donne
Cinq sortes de fiches, dans leur état publié. Les ébauches en sont absentes : le site crée automatiquement une fiche vide quand une fiche publiée en cite une autre, et ces coquilles n'ont rien à dire.
| Type | Adresse | Fiches publiées |
|---|---|---|
| Philosophes | /api/public/entities/philosophes |
232 |
| Œuvres | /api/public/entities/oeuvres |
217 |
| Concepts | /api/public/entities/concepts |
112 |
| Courants de pensée | /api/public/entities/courants |
82 |
| Lieux | /api/public/entities/lieux |
33 |
Interroger une liste
Une liste se parcourt page par page. page commence à 1 et
par_page vaut 50 par défaut, 100 au maximum.
La réponse porte la licence, le type demandé, la pagination et les fiches. Une propriété absente de la base est absente de la réponse : il n'y a ni chaîne vide ni date inventée.
{ "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", ... } ] }Interroger une fiche
Le détail d'une fiche ajoute ses rattachements : les concepts qu'un philosophe travaille, les œuvres qu'il a écrites, les courants auxquels il se rattache. Chacun vient avec son slug et l'adresse de sa propre fiche.
GET https://philotopie.fr/api/public/entities/philosophes/spinozaConditions d'usage
Pas d'authentification, pas de quota. L'API est servie avec une
en-tête Access-Control-Allow-Origin: *, donc utilisable
depuis un navigateur, et une mise en cache d'une heure. Nous vous
demandons seulement de ne pas la marteler : les données changent de
jour en jour, pas de seconde en seconde.
Ce que l'API ne donne pas
- Le corps long des fiches : biographies, analyses et définitions longues restent sur le site, où ils sont relus et mis en forme.
- Les fiches non publiées.
- Les images elles-mêmes : la réponse en donne l'adresse, et l'image reste soumise à son propre crédit, indiqué sur la fiche.
- Toute écriture : l'API est en lecture seule.
Une question, un usage à signaler
Si vous construisez quelque chose sur ces données, nous sommes curieux de le savoir, et prêts à faire évoluer l'API si elle vous manque quelque part. Écrivez-nous par la page de contact.