RÉPUBLIQUE FRANÇAISE

Documentation API

Intégrez les services de vérification de documents dans vos applications

Version 1.0.0REST API

Navigation

Démarrage rapide

L\'API MES DÉCLARATIONS permet d\'intégrer facilement les fonctionnalités de vérification et de soumission de documents dans vos applications.

URL de base

https://api.mes-declarations.fr/v1

Authentification

L\'API utilise des tokens JWT pour l\'authentification. Incluez le token dans l\'en-tête Authorization :

Authorization: Bearer YOUR_TOKEN

Endpoints auth

POST/api/auth/login

Authentification utilisateur

Exemple de requête

curl -X POST \
  /api/auth/login \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"key": "value"}'

Réponse

{
  "success": true,
  "data": {
    "id": "12345",
    "status": "success"
  }
}
GET/api/auth/me

Obtenir les informations de l'utilisateur connecté

Exemple de requête

curl -X GET \
  /api/auth/me \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"

Réponse

{
  "success": true,
  "data": {
    "id": "12345",
    "status": "success"
  }
}
POST/api/auth/logout

Déconnexion

Exemple de requête

curl -X POST \
  /api/auth/logout \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"key": "value"}'

Réponse

{
  "success": true,
  "data": {
    "id": "12345",
    "status": "success"
  }
}

Limites de taux

L\'API est limitée à 100 requêtes par minute par clé API. Les en-têtes de réponse incluent les informations de limite :

  • X-RateLimit-Limit: Nombre maximum de requêtes
  • X-RateLimit-Remaining: Requêtes restantes
  • X-RateLimit-Reset: Temps avant réinitialisation