ENTWICKLER · API & CLIENTS

REST-API und OpenAPI 3.1 — ein Client in jeder Sprache.

Die REST-API ist die maßgebliche Schnittstelle. Aus der OpenAPI-3.1-Spezifikation erzeugen Sie in jeder Sprache einen typsicheren Client — mit denselben Endpunkten und Parameternamen, die auch die API verwendet. Automatisches Retry, Idempotency-Key und exponentielles Backoff bilden Sie über dieselben Header ab.

Eine Spezifikation · ein Befehl · Ihre Sprache
# OpenAPI-3.1-Spezifikation
https://api.sendnomi.com/v1/openapi.json

# Typsicheren Client in Ihrer Sprache erzeugen
openapi-generator-cli generate \
  -i https://api.sendnomi.com/v1/openapi.json \
  -g typescript-fetch \
  -o ./sendnomi-client

Zeigen Sie einen beliebigen OpenAPI-Generator auf /v1/openapi.json und tauschen Sie das Ziel (-g) gegen Ihre Sprache. Der erzeugte Client bildet die API 1:1 ab — inklusive Typen, Idempotency-Key und einheitlichem Fehlermodell.

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

Die REST-API bleibt die einzige maßgebliche Quelle; jeder generierte Client spricht dieselben Endpunkte mit denselben Parameternamen — der Wechsel zwischen Sprachen ist schmerzlos. Die Spezifikation folgt semantischer Versionierung (SemVer); neue API-Versionen kommen mit einem Deprecation-Fenster, nie über Nacht.