SDK (Software Development Kit)

Ein SDK ist eine vorgefertigte Code-Bibliothek, die die Integration mit der SendSeven API in Ihrer bevorzugten Programmiersprache vereinfacht. Statt rohe HTTP-Anfragen zu schreiben, nutzen Sie typsichere Funktionen mit automatischer Fehlerbehandlung.

Was ist ein SDK?

Ein Software Development Kit (SDK) ist eine Sammlung von Tools, Bibliotheken und Code-Beispielen, die Entwicklern die Arbeit mit einer API erleichtern. Anstatt manuell HTTP-Requests zu bauen, JSON zu parsen und Fehler abzufangen, rufen Sie einfach Funktionen wie sendMessage() oder getContacts() auf – das SDK kümmert sich um den Rest.

SDKs bieten mehrere Vorteile gegenüber rohen API-Calls: Typsicherheit (Ihre IDE zeigt Ihnen verfügbare Felder und erkennt Fehler vor dem Deployment), automatische Fehlerbehandlung (Retry-Logik, Timeout-Management), Abstraktion (komplexe Workflows wie OAuth oder Pagination werden vereinfacht) und Best Practices (das SDK implementiert bereits die empfohlene Nutzung der API).

SDK vs. direkte REST API

Die SendSeven API ist eine REST API – Sie könnten sie theoretisch mit jedem HTTP-Client nutzen (mehr dazu im Authentifizierungs-Guide) (curl, Postman, fetch(), axios). Ein SDK ist eine dünne Schicht darüber, die sprachspezifische Komfort-Features bietet:

Ohne SDK (roher API-Call in JavaScript):

const response = await fetch('https://api.sendseven.com/api/v1/messages', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    to: '+491701234567',
    channel: 'whatsapp',
    content: { text: 'Hallo!' }
  })
});
const data = await response.json();
if (!response.ok) throw new Error(data.message);

Mit SDK (Node.js):

const SendSeven = require('@sendseven/sdk');
const client = new SendSeven({ apiKey: 'YOUR_API_KEY' });

await client.messages.send({
  to: '+491701234567',
  channel: 'whatsapp',
  text: 'Hallo!'
});

Der SDK-Code ist kürzer, lesbarer und fehlerresistenter. Typen verhindern Tippfehler (z. B. chennel statt channel), und das SDK wirft automatisch verständliche Exceptions bei Fehlern.

Unterstützte Sprachen bei SendSeven

SendSeven bietet offizielle SDKs für die gängigsten Programmiersprachen:

• Node.js/TypeScript: Vollständig typsicher mit IntelliSense-Unterstützung
• Python: Mit Type Hints und async/await Support
• PHP: PSR-4-kompatibel, Composer-Installation

Alle SDKs sind Open Source (MIT-Lizenz) und werden parallel zur API weiterentwickelt. Sie finden sie auf GitHub und in den jeweiligen Paket-Registries (npm, PyPI, Packagist). Die Dokumentation enthält Quick-Start-Guides, Code-Beispiele und API-Referenzen.

Nutzen Sie eine andere Sprache (Go, Ruby, Java, .NET)? Die REST API ist sprachunabhängig – Sie können sie mit jedem HTTP-Client nutzen. Community-SDKs existieren teilweise bereits, oder Sie entwickeln einen eigenen Wrapper (Pull Requests auf GitHub sind willkommen!).

Getting Started mit SendSeven SDKs

Node.js:

npm install @sendseven/sdk
const SendSeven = require('@sendseven/sdk');
const client = new SendSeven({ apiKey: process.env.SENDSEVEN_API_KEY });

Python:

pip install sendseven
from sendseven import SendSeven
client = SendSeven(api_key=os.getenv('SENDSEVEN_API_KEY'))

PHP:

composer require sendseven/sdk
use SendSeven\Client;
$client = new Client(['api_key' => getenv('SENDSEVEN_API_KEY')]);

Alle SDKs unterstützen Environment Variables für API Keys (niemals hardcoded!), haben integriertes Logging (für Debugging) und bieten Webhook-Helpers (zum Validieren eingehender Webhook-Signaturen). Die vollständige Dokumentation mit Beispielen für alle Features finden Sie unter /de/dokumentation.