API Documentation

Documentation API

Intégrez facilement les données juridiques de Mr Impôt dans vos applications.

Authentification

Toutes les requêtes doivent inclure une clé API dans l'en-tête Authorization.

Authorization: Bearer votre_clé_api

Pour obtenir une clé, contactez-nous à api@mrimpôt.com.

Endpoints disponibles

Récupère la liste des documents (avec pagination et filtres)

Paramètres

Nom	Type	Description
category	string	Filtre par catégorie (ex: fiscal, societes)
limit	integer	Nombre de résultats par page (max 50)(défaut: 20)
page	integer	Numéro de la page(défaut: 1)
search	string	Recherche par mots-clés

Exemple

curl -X GET "https://api.mrimpôt.com/v1/documents?category=fiscal&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Récupère un document spécifique par son identifiant

Paramètres

Nom	Type	Description
id	string	Identifiant unique du document

Exemple

curl -X GET "https://api.mrimpôt.com/v1/documents/doc_123456" \
  -H "Authorization: Bearer YOUR_API_KEY"

Recherche avancée dans tous les contenus (documents, vidéos, jurisprudence)

Paramètres

Nom	Type	Description
q	string	*Requête de recherche
type	string	Filtre par type (document, video, jurisprudence)
limit	integer	Nombre de résultats(défaut: 20)

Exemple

curl -X GET "https://api.mrimpôt.com/v1/search?q=licenciement+économique&type=document" \
  -H "Authorization: Bearer YOUR_API_KEY"

Ajoute un document aux favoris de l'utilisateur authentifié

Paramètres

Nom	Type	Description
document_id	string	*ID du document

Exemple

curl -X POST "https://api.mrimpôt.com/v1/users/favorites" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"document_id": "doc_123456"}'

Exemples de code (SDK)

import { MrImpôtAPI } from 'mrimpôt-sdk';

const api = new MrImpôtAPI('YOUR_API_KEY');

// Récupérer les documents fiscaux
const documents = await api.documents.list({
  category: 'fiscal',
  limit: 10
});

console.log(documents);

Les SDK officiels sont disponibles sur GitHub.

Limites d'utilisation

• Gratuit : 1000 requêtes par jour
• Professionnel : 10 000 requêtes par jour
• Entreprise : limites personnalisables
• Taux de rafraîchissement : 10 requêtes/seconde maximum

Demander une clé API