Développeurs

Portail développeur

Intégrez la base de connaissances dans vos applications grâce à l’API REST, au format JSON.

Accès

Les points d’accès de consultation ci-dessous sont en lecture seule et ne demandent pas de clé. Les routes protégées utilisent un jeton Bearer :

Authorization: Bearer {votre_token_api}

Recherche de documents

Point d’entrée principal pour interroger la base de connaissances.

GET https://databaseoftheknowledgeofhumanity.com/api/documents?q=astronomie&region=Andalousie&document_type=Article

Paramètres de requête de la recherche de documents
Paramètre	Description
`q`	Terme de recherche (facultatif)
`region`	Filtre géographique (facultatif)
`document_type`	Type de document (facultatif)
`language`	Code de langue ISO (facultatif)
`year_from / year_to`	Période (facultatif)
`page`	Pagination (par défaut : 1)
`per_page`	Résultats par page (par défaut : 20, maximum : 100)

Détail d’un document

GET https://databaseoftheknowledgeofhumanity.com/api/documents/{slug}

Collections

GET https://databaseoftheknowledgeofhumanity.com/api/collections
GET https://databaseoftheknowledgeofhumanity.com/api/collections/{slug}

Exemple de réponse

Exemple illustratif : les valeurs sont fictives.

{
  "data": [
    {
      "id": 1,
      "title": "Titre du document",
      "summary": "Résumé du document…",
      "slug": "titre-du-document",
      "language": "fr",
      "year": 1523,
      "institution": "Institution source",
      "document_type": "Article",
      "region": "Atlantique",
      "tags": ["Navigation", "Manuscrit"]
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 20,
    "total": 1
  }
}