DÉVELOPPEUR · API & CLIENTS

API REST et OpenAPI 3.1 — un client dans n'importe quel langage.

L'API REST est l'interface de référence. Depuis la spécification OpenAPI 3.1, vous générez un client typé dans le langage de votre choix — avec les mêmes endpoints et les mêmes noms de paramètres que l'API. Nouvelle tentative automatique, clé d'idempotence et backoff exponentiel se pilotent via les mêmes en-têtes.

Une spécification · une commande · votre langage
# Spécification OpenAPI 3.1
https://api.sendnomi.com/v1/openapi.json

# Générer un client typé dans votre langage
openapi-generator-cli generate \
  -i https://api.sendnomi.com/v1/openapi.json \
  -g typescript-fetch \
  -o ./sendnomi-client

Pointez n'importe quel générateur OpenAPI sur /v1/openapi.json et remplacez la cible (-g) par votre langage. Le client généré reflète l'API à l'identique — types, clé d'idempotence et modèle d'erreur unifié inclus.

TypeScript / JavaScript
-g typescript-fetch
Python
-g python
Go
-g go
PHP
-g php
Ruby
-g ruby
Java / Kotlin
-g java
.NET / C#
-g csharp
Rust
-g rust

L'API REST reste la seule source de référence ; chaque client généré appelle les mêmes endpoints avec les mêmes noms de paramètres — passer d'un langage à l'autre se fait sans effort. La spécification suit le versionnage sémantique (SemVer) ; les nouvelles versions d'API arrivent avec une fenêtre de dépréciation, jamais du jour au lendemain.