# API

{% hint style="info" %}
**Qu’est-ce qu’une API ?**

Une API est une interface, un contrat passé entre deux systèmes informatiques pour leur permettre de communiquer. Cette solution informatique permet d’automatiser des tâches depuis votre ordinateur ou vos serveurs.\
[Source](https://guides.data.gouv.fr/publier-des-donnees/guide-data.gouv.fr/api)[ : data.gouv.fr](https://guides.data.gouv.fr/publier-des-donnees/guide-data.gouv.fr/api)
{% endhint %}

## API data.gouv.fr pour publier les données

Plus d'informations[ ici.](https://doc.transport.data.gouv.fr/administration-des-donnees/procedures-de-publication/publier-un-jeu-de-donnees/3.-methode-par-api)

## API de transport.data.gouv.fr pour réutiliser les données&#x20;

Le PAN propose une API, sans authentification ni quota, en JSON. Elle diffuse des informations sur les jeux de données, ressources, AOMs, historisations, validations conduites par le PAN.

L'API permet :

* d'automatiser la récupération des informations affichées sur le site web ;
* de construire des automatisations spécifiques à vos besoins, en autonomie ;
* de suivre les dernières informations disponibles sur l'intégralité du catalogue du PAN.

Pour découvrir l'API, rendez-vous sur le portail "Swagger" ici <https://transport.data.gouv.fr/swaggerui>.

Les opérations disponibles (endpoints) sont décrites, ainsi que les paramètres éventuels et la structure des réponses.

Le endpoint le plus important est celui qui retourne, en un seul appel, la liste de la totalité des datasets et ressources associées:

* `https://transport.data.gouv.fr/api/datasets`

Une fois que vous disposez de l'identifiant du dataset, vous pouvez si vous le souhaitez récupérer une version plus détaillée (avec notamment l'historique des changements de ressources, les conversions éventuellement réalisées) ici:

* `https://transport.data.gouv.fr/api/datasets/:id`

Une section d'opérations permet aussi de récupérer les informations liées aux Autorités Organisatrices de la Mobilité.

Certaines opérations n'ont d'utilité que pour le PAN lui-même, mais sont disponibles malgré tout.

{% hint style="info" %}
N'hésitez pas à nous contacter en cas de besoin, nous sommes à votre disposition pour vous aider ! (voir onglet [Contact PAN](https://doc.transport.data.gouv.fr/documentation/contact-pan))
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.transport.data.gouv.fr/outils/outils-disponibles-sur-le-pan/api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
