# Introduction

> Ce que l'API Partenaire BackResto expose aujourd'hui, ce qu'elle n'expose délibérément pas, et qui décide.

Source: https://developers.backresto.com/fr/docs/introduction

BackResto est l'application de conformité HACCP que les équipes de la
restauration remplissent pendant le service : contrôles à réception,
températures de cuisson et de refroidissement, plans de nettoyage, étiquettes.
L'**API Partenaire** transmet ces enregistrements au logiciel que vos clients
utilisent déjà : un ERP, un portail fournisseur, un tableau de bord qualité, un
assistant IA.

C'est une API HTTP en lecture seule, avec un schéma d'authentification et une
forme d'erreur, décrite de bout en bout par un
[document OpenAPI](https://api.backresto.com/openapi.json) que vous pouvez
charger directement dans un générateur de client ou dans une définition d'outil
pour LLM. Les mêmes données sont accessibles en [MCP](https://developers.backresto.com/fr/docs/mcp) à l'adresse
`https://api.backresto.com/mcp`, avec la même clé et les mêmes autorisations, si
ce que vous voulez c'est poser des questions plutôt qu'écrire un client.

## C'est le restaurant qui décide de ce que vous voyez

C'est le passage qui mérite d'être lu deux fois, parce qu'il diffère de la
plupart des API que vous intégrerez.

Il n'y a pas d'inscription. Une clé est émise à la main, limitée à des
restaurants nommés et à des scopes nommés, et seulement une fois que les
restaurants concernés y ont consenti. Demandez-en une par e-mail
([Obtenir une clé](https://developers.backresto.com/fr/docs/access) est la liste de contrôle) et elle arrive chez
le contact technique que vous désignez.

La conséquence est ferme : une clé atteint les restaurants pour lesquels elle a
été accordée et rien d'autre. `restaurant-3` n'apparaît pas parce que
`restaurant-1` et `restaurant-2` sont sur la même clé, et aucune requête que
vous puissiez faire n'élargit cela. Ajouter un site est une autre conversation,
avec les personnes à qui appartiennent les données.

L'avantage d'une petite étape manuelle, c'est que la révocation est tout aussi
directe : un e-mail et la clé est morte dès la requête suivante.

## Ce que contiennent les données

| Ressource | Ce que c'est |
| --- | --- |
| [Livraisons](https://developers.backresto.com/fr/docs/deliveries) | Deux collections : un enregistrement par contrôle à réception (fournisseur, verdict de conformité, motifs de non-conformité, actions correctives, commentaire en texte libre, un relevé de température par produit, toujours en degrés Celsius), et les photos prises à la réception. |
| [Collections et enregistrements](https://developers.backresto.com/fr/docs/collections) | Vingt-quatre autres types d'enregistrement, partageant une seule enveloppe et documentés par domaine : [températures](https://developers.backresto.com/fr/docs/temperatures), [refroidissement et procédés alimentaires](https://developers.backresto.com/fr/docs/food-processes), [nettoyage](https://developers.backresto.com/fr/docs/cleaning), [friteuses](https://developers.backresto.com/fr/docs/fryers), [analyses de surface](https://developers.backresto.com/fr/docs/surface-analyses), [étiquettes de traçabilité](https://developers.backresto.com/fr/docs/traceability-labels), [documents](https://developers.backresto.com/fr/docs/drive-files), [catalogue](https://developers.backresto.com/fr/docs/catalogue) et les [équipements et personnes](https://developers.backresto.com/fr/docs/facilities) qui sont derrière. |

Tout cela est en lecture seule. Rien de ce qu'une clé partenaire peut appeler
n'écrit dans les enregistrements d'un restaurant. C'est dans l'application que
les données de conformité sont créées, par la personne qui en est responsable.

## Ce qui n'est pas encore là

Être explicite sur les limites vous fait gagner un après-midi :

- **Pas de reprise de l'historique.** Les enregistrements d'un restaurant
  deviennent visibles pour cette API à partir du moment où la capture est
  activée pour ce restaurant. Ce qui précède est dans l'application, pas ici, sauf
  pour les livraisons, qui portent l'historique que l'application détenait
  encore. Ne prenez pas un parcours vide pour la preuve que rien ne s'est
  passé. Voyez [Support](https://developers.backresto.com/fr/docs/support).
- **Pas d'écriture, pas de webhooks.** Vous interrogez l'API. Si vous avez
  besoin qu'on vous pousse les données, dites-le-nous ; c'est une question de
  demande, pas de principe.
- **Pas de curseur incrémental sur les collections.** Actualiser une collection
  veut dire la parcourir à nouveau et réconcilier sur `id`.
- **Pas de connexion avec un compte BackResto.** La clé partenaire reste
  l'identifiant. Les clients [MCP](https://developers.backresto.com/fr/docs/mcp) qui ne demandent qu'une URL,
  comme Claude et ChatGPT, peuvent se connecter par OAuth : une page BackResto
  s'ouvre pour y coller la clé. Les autorisations restent celles de cette clé.

## URL de base

| Environnement | Origine |
| --- | --- |
| Production | `https://api.backresto.com` |
| Préproduction | `https://api-preprod.backresto.com` |
| Développement | `https://api-dev.backresto.com` |

Une clé est provisionnée dans un environnement et ne vaut rien dans les autres :
les clés, les autorisations et les données sont propres à chaque environnement.
Tout ce qui suit utilise l'origine de production.

Prêt ? [Faites votre premier appel](https://developers.backresto.com/fr/docs/quickstart).