IFG - Documentation API

Introduction

L'API IFG permet d'interroger notre moteur d'intelligence fiscale depuis n'importe quelle application. Vous pouvez obtenir des réponses fiscales précises pour 80+ pays en temps réel.

Base URL

https://ifg.app/api/v1

Authentification

Toutes les requêtes doivent inclure une clé API dans le header X-API-Key.

Créez votre clé API sur cette page.

Endpoint Principal

POST /api/v1/query

Interroge IFG sur une question fiscale

Request Body

Paramètre	Type	Requis	Description
`question`	string	REQUIS	Votre question fiscale
`country`	string	OPTIONNEL	Code pays ISO (ex: FR, US, CH). Défaut: FR
`countryB`	string	OPTIONNEL	2ème pays pour questions bilatérales
`mode`	string	OPTIONNEL	"quick" (rapide) ou "expert" (détaillé). Défaut: quick

Response

{
  "answer": "Le taux de TVA normal en France est de 20%...",
  "sources": [
    {
      "title": "BOFiP - TVA Taux",
      "url": "https://bofip.impots.gouv.fr/..."
    }
  ],
  "model": "mistral-large-latest",
  "requestId": "abc123..."
}

Exemple cURL

curl -X POST https://ifg.app/api/v1/query \
  -H "Content-Type: application/json" \
  -H "X-API-Key: VOTRE_CLE_API" \
  -d '{
    "question": "Quel est le taux de TVA en France ?",
    "country": "FR",
    "mode": "expert"
  }'

Exemple JavaScript

const response = await fetch('https://ifg.app/api/v1/query', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'VOTRE_CLE_API'
  },
  body: JSON.stringify({
    question: "Quel est le taux de TVA en France ?",
    country: "FR",
    mode: "expert"
  })
});

const data = await response.json();
console.log(data.answer);

Exemple Python

import requests

response = requests.post(
    'https://ifg.app/api/v1/query',
    headers={
        'Content-Type': 'application/json',
        'X-API-Key': 'VOTRE_CLE_API'
    },
    json={
        'question': 'Quel est le taux de TVA en France ?',
        'country': 'FR',
        'mode': 'expert'
    }
)

data = response.json()
print(data['answer'])

Quotas & Limites

Plan	Requêtes/mois	Mode	Prix
Free	100	Quick uniquement	0€
Pro	Illimité	Quick + Expert	49€/mois
Enterprise	Illimité	Quick + Expert + White-label	Sur devis

Codes d'Erreur

Code	Message	Description
`400`	Bad Request	Paramètre manquant ou invalide
`401`	Unauthorized	Clé API manquante ou invalide
`429`	Too Many Requests	Quota dépassé
`500`	Internal Server Error	Erreur serveur

Support

Pour toute question technique, contactez-nous :

Email: api@ifg.app
Documentation: docs.ifg.app

📚 Documentation API IFG