Nouveau Recherche PDF, HTML, DOCX et bien d'autres formats.

Portail développeur

Intégrez la base de connaissances dans vos applications via notre API REST

Authentification

L'API utilise l'authentification par token Bearer. Obtenez votre clé dans votre profil utilisateur.

Authorization: Bearer {votre_token_api}

Recherche de documents

Endpoint principal pour rechercher dans la base de connaissances.

GET /api/documents

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

Paramètres de requête :

  • q - Terme de recherche (optionnel)
  • region - Filtre géographique (optionnel)
  • document_type - Type de document (optionnel)
  • language - Code langue ISO (optionnel)
  • year_from / year_to - Période (optionnel)
  • page - Pagination (défaut: 1)
  • per_page - Résultats par page (défaut: 20, max: 100)

Détails d'un document

GET /api/documents/{slug}

GET https://databaseoftheknowledgeofhumanity.com/api/documents/traites-nautiques-routes-stellaires

Collections

GET /api/collections

GET https://databaseoftheknowledgeofhumanity.com/api/collections

GET /api/collections/{slug}

GET https://databaseoftheknowledgeofhumanity.com/api/collections/civilisations-andines

Exemple de réponse

{
  "data": [
    {
      "id": 1,
      "title": "Traités nautiques...",
      "summary": "Compilation des consignes...",
      "slug": "traites-nautiques-routes-stellaires",
      "language": "fr",
      "year": 1523,
      "institution": "Université de Lisbonne",
      "document_type": "Article",
      "region": "Atlantique",
      "tags": ["Navigation", "XVIe", "Manuscrit"]
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 20,
    "total": 2543
  }
}