Répartition de la dette

Commencer

L'API Budget fournit un accès programmatique aux données budgétaires publiques. Tous les points de terminaison retournent des réponses au format JSON et supportent divers paramètres de requête pour le filtrage et la pagination.

Format de réponse

Toutes les réponses sont retournées au format JSON avec les codes de statut HTTP appropriés.

Authentification

Actuellement, cette API ne nécessite pas d'authentification pour l'accès aux données publiques. Tous les points de terminaison sont accessibles au public.

Remarque

Une limitation de débit peut s'appliquer pour prévenir les abus. Veuillez nous contacter si vous avez besoin de limites de débit plus élevées pour votre application.

Totaux du Budget

Récupérer les chiffres totaux du budget, y compris les dépenses et les ressources pour toutes les années, couvrant à la fois le budget principal et les budgets complémentaires.

GET /budget/api/totals/

Paramètres

Paramètre	Type	Description
`year`	integer	Filtrer par année spécifique
`include_complementary`	boolean	Inclure les budgets complémentaires

Réponse

Le corps de la réponse est formaté en JSON avec la structure suivante:

Champ	Type	Description
`year`	integer	Année budgétaire
`total_expenses`	number	Total des dépenses
`total_resources`	number	Total des ressources
`balance`	number	Solde budgétaire

Catégories Budgétaires

Récupérer les données budgétaires organisées par catégories, y compris les dépenses et les ressources.

GET /budget/api/budget-categories/

Paramètres

Paramètre	Type	Description
`year`	integer	Filtrer par année budgétaire
`type`	string	Filtrer par type : 'dépense' ou 'ressource'

Réponse

Le corps de la réponse est formaté en JSON avec la structure suivante:

Champ	Type	Description
`category`	string	Nom de la catégorie
`expenses`	number	Total des dépenses dans la catégorie
`resources`	number	Total des ressources dans la catégorie

Dépenses

Récupérer les dépenses budgétaires avec une structure hiérarchique optionnelle. Ce point de terminaison vous permet d'explorer les données de dépenses à différents niveaux de détail.

GET /budget/api/expenses/

Paramètres

Paramètre	Type	Description
`year`	integer	Filtrer les dépenses par année budgétaire
`hierarchy`	boolean	Retourner la structure hiérarchique si vrai
`organization`	integer	Filtrer par ID d'organisation
`limit`	integer	Nombre de résultats à retourner par page
`offset`	integer	L'index initial à partir duquel retourner les résultats

Réponse

Le corps de la réponse est formaté en JSON avec la structure suivante:

Champ	Type	Description
`id`	integer	Identifiant de l'enregistrement de dépense
`year`	integer	Année budgétaire
`amount`	number	Montant de la dépense
`category`	string	Catégorie de dépense
`organization`	object	Détails de l'organisation associée

Ressources

Récupérer les ressources budgétaires avec une structure hiérarchique optionnelle. Les ressources représentent les revenus et les sources de financement.

GET /budget/api/resources/

Paramètres

Paramètre	Type	Description
`year`	integer	Filtrer les ressources par année budgétaire
`hierarchy`	boolean	Retourner la structure hiérarchique si vrai
`limit`	integer	Nombre de résultats à retourner par page
`offset`	integer	L'index initial à partir duquel retourner les résultats

Réponse

Le corps de la réponse est formaté en JSON avec la structure suivante:

Champ	Type	Description
`id`	integer	Identifiant de l'enregistrement de ressource
`year`	integer	Année budgétaire
`amount`	number	Montant de la ressource
`source`	string	Source ou type de ressource

Liste des Organisations

Récupérer une liste d'organisations avec leurs détails, y compris le nom, le code et les informations budgétaires associées.

GET /budget/api/organization/

Paramètres

Paramètre	Type	Description
`year`	integer	Filtrer les organisations par année budgétaire
`limit`	integer	Nombre de résultats à retourner par page
`offset`	integer	L'index initial à partir duquel retourner les résultats

Réponse

Le corps de la réponse est formaté en JSON avec la structure suivante:

Champ	Type	Description
`id`	integer	Identifiant unique pour l'organisation
`name`	string	Nom de l'organisation
`code`	string	Code d'organisation

Statistiques des Organisations

Récupérer les informations statistiques et les données agrégées pour les organisations.

GET /budget/api/organization/stats/

Paramètres

Paramètre	Type	Description
`year`	integer	Filtrer les statistiques par année budgétaire
`organization_id`	integer	Filtrer par ID d'organisation spécifique

Réponse

Le corps de la réponse est formaté en JSON avec la structure suivante:

Champ	Type	Description
`organization_id`	integer	Identifiant d'organisation
`total_expenses`	number	Montant total des dépenses
`total_resources`	number	Montant total des ressources

Dette

Récupérer les informations sur la dette par origine et année.

GET /budget/api/debt/

Paramètres

Paramètre	Type	Description
`year`	integer	Filtrer les données de dette par année
`parent`	string	Filtrer par origine de dette parent (utiliser 'null' pour les origines de premier niveau)

Réponse

Le corps de la réponse est formaté en JSON avec la structure suivante:

Champ	Type	Description
`year`	integer	Année de l'enregistrement de la dette
`debt_origin`	object	Informations sur l'origine de la dette (id, parent, nom)
`value`	number	Valeur de la dette en MDT (Million de Dinars Tunisiens)

Dette en Cours

Récupérer les informations sur la dette en cours - le montant total d'argent encore dû qui n'a pas encore été remboursé, y compris le principal restant, les intérêts accumulés et les frais associés.

GET /budget/api/outstanding-debt/

Paramètres

Paramètre	Type	Description
`year`	integer or 'last'	Filtrer par année ou utiliser 'last' pour l'année la plus récente

Réponse

Le corps de la réponse est formaté en JSON avec la structure suivante:

Champ	Type	Description
`year`	integer	Année de l'enregistrement de la dette en cours
`outstanding_debt`	number	Montant total de la dette en cours en MDT (principal restant, intérêts et frais)
`gdp`	number	PIB en MDT
`value`	number	Dette en cours en pourcentage du PIB

Déficit

Récupérer les informations sur le déficit budgétaire, y compris les valeurs absolues et le pourcentage par rapport au PIB.

GET /budget/api/deficit/

Réponse

Le corps de la réponse est formaté en JSON avec la structure suivante:

Champ	Type	Description
`year`	integer	Année budgétaire
`value`	number	Valeur absolue du déficit en MDT
`percent`	number	Déficit en pourcentage du PIB
`gdp`	number	PIB en MDT