---
title: "API REST"
description: "Une API REST est une interface web qui expose des ressources, comme des messages, des contacts ou des modèles, à des URL et permet aux programmes de les créer, lire, modifier et supprimer avec les méthodes HTTP standard (POST, GET, PATCH, DELETE), généralement en échangeant du JSON."
canonical: "https://omnichannels.ai/fr/glossary/rest-api/"
language: "fr"
updated: "2026-10-10"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
---

# API REST

Canonical: https://omnichannels.ai/fr/glossary/rest-api/
Language: fr
Publisher: OmniChannels.ai by BroadNet Technologies

**Définition:** Une API REST est une interface web qui expose des ressources, comme des messages, des contacts ou des modèles, à des URL et permet aux programmes de les créer, lire, modifier et supprimer avec les méthodes HTTP standard (POST, GET, PATCH, DELETE), généralement en échangeant du JSON.

REST (representational state transfer) est un style d'architecture décrit par Roy Fielding en 2000. En pratique, une API REST de messagerie consiste à envoyer une requête HTTPS authentifiée, par exemple POST /messages avec un corps JSON, et à recevoir une réponse JSON contenant un identifiant et un statut. Les codes de statut HTTP indiquent le résultat : 2xx pour un succès, 4xx pour les erreurs client comme un numéro invalide ou une autorisation manquante, 5xx pour les erreurs serveur.

Pratiques courantes : authentification par jeton bearer dans l'en-tête Authorization, clés d'idempotence pour que les nouvelles tentatives n'envoient pas de doublons, pagination des listes, limites de débit avec en-têtes retry-after, et webhooks pour les résultats asynchrones comme les accusés de réception.

REST convient à la plupart des intégrations : CRM, plateformes e-commerce et systèmes de back-office. Pour les très gros volumes de SMS, opérateurs et agrégateurs utilisent souvent plutôt SMPP, qui maintient une connexion persistante.

Une spécification OpenAPI décrit les points d'accès sous une forme lisible par machine, ce qui permet d'en générer des SDK clients, de la documentation et des tests.

OmniChannels.ai fournit une API REST/JSON à l'adresse https://api.broadnet.me avec authentification par jeton bearer, une spécification OpenAPI 3.1 et un SDK TypeScript.

## Exemple

```
POST https://api.broadnet.me/… avec l'en-tête "Authorization: Bearer <token>" et un corps JSON ; la réponse renvoie un identifiant de message.
```

## Sources

- [Fielding, Architectural Styles and the Design of Network-based Software Architectures, ch. 5 (REST)](https://ics.uci.edu/~fielding/pubs/dissertation/rest_arch_style.htm)
- [RFC 9110: HTTP Semantics (IETF)](https://datatracker.ietf.org/doc/html/rfc9110)