Sinch SDKs
Überblick
Querschnittskompetenz für die SDK-Installation und Client-Initialisierung aller Sinch-Produkte. Ermittelt das korrekte SDK und liefert den Initialisierungscode pro Sprache.
Informationen zur Einrichtung der Authentifizierung (Credentials, OAuth2, Basic Auth, signierte Anfragen) finden Sie unter sinch-authentication. Für In-App-Calling-SDKs (Browser, iOS, Android) siehe sinch-in-app-calling.
Anweisungen für den Agenten
Wenn der Benutzer keine Sprache oder Plattform angegeben hat, fragen Sie zuerst nach – das SDK und das Initialisierungsmuster unterscheiden sich je nach Sprache. Verwenden Sie die folgende Tabelle, um zur richtigen Referenz weiterzuleiten.
SDK-Installation
| Sprache | Paket | Installation | Auth-Bereich |
|---|---|---|---|
| Node.js | @sinch/sdk-core | npm install @sinch/sdk-core | Projekt + Anwendung |
| Python | sinch | pip install sinch | Projekt + Anwendung |
| Java | com.sinch.sdk:sinch-sdk-java | Maven-Abhängigkeit | Projekt + Anwendung |
| .NET | Sinch | NuGet-Paket | Projekt + Anwendung |
In-App-Calling verwendet ein separates clientseitiges SDK – nicht @sinch/sdk-core. Siehe sinch-in-app-calling.
Produktabdeckung nach SDK
Nicht alle Produkte sind in allen SDKs verfügbar. Überprüfen Sie die Tabelle, bevor Sie ein SDK für ein bestimmtes Produkt empfehlen.
| Produkt | Node.js | Java | .NET | Python |
|---|---|---|---|---|
| Conversation API | ✅ | ✅ | ⚠️ | ⚠️ |
| Voice API | ✅ | ✅ | ✅ | ✅ |
| Verification API | ✅ | ✅ | ✅ | ✅ |
| Numbers API | ✅ | ✅ | ✅ | ✅ |
| Number Lookup API | ✅ | ❌ | ❌ | ✅ |
| Elastic SIP Trunking | ✅ | ❌ | ❌ | ❌ |
| Fax API | ✅ | ❌ | ⚠️ | ❌ |
| Provisioning API | ✅ | ❌ | ❌ | ❌ |
| 10DLC Registration | ❌ | ❌ | ❌ | ❌ |
✅ = unterstützt, ⚠️ = teilweise/Vorschau, ❌ = nicht verfügbar (direkte HTTP-Aufrufe verwenden)
Wenn ein Produkt im SDK des Benutzers nicht unterstützt wird, leiten Sie ihn an, stattdessen direkte HTTP-Aufrufe zu verwenden.
SDK-Init-Referenzen
Sprachspezifische Initialisierungscodes finden Sie in den Referenzen:
- Node.js: references/sdk-init-node.md
- Python: references/sdk-init-python.md
- Java: references/sdk-init-java.md
- .NET: references/sdk-init-dotnet.md
Wenn die Sprache unbekannt ist, fragen Sie zuerst. Die SDKs kümmern sich automatisch um die Token-Aktualisierung.
Schlüsselkonzepte
@sinch/sdk-core — Einheitliches Node.js-SDK, das alle projekt- und anwendungsbezogenen Sinch-APIs abdeckt. Einzelne Pakete (z. B. @sinch/voice, @sinch/verification) sind ebenfalls verfügbar.
sinch (Python) — Python-SDK (v2.0.0+) für projekt- und anwendungsbezogene APIs.
sinch-sdk-java — Java-SDK (v2.0.0+) über Maven Central.
Projektbezogene Initialisierung — Verwendet projectId, keyId, keySecret. Für Conversation, Numbers, Fax, EST, 10DLC, Number Lookup, Provisioning.
Anwendungsbezogene Initialisierung — Verwendet applicationKey, applicationSecret. Für Voice, Verification, In-App-Calling.
Multi-Produkt-Client — Übergeben Sie sowohl Projekt- als auch Anwendungs-Credentials in einem einzigen SinchClient, um auf alle APIs zuzugreifen.
Conversation-Region — Muss bei Verwendung der Conversation API explizit gesetzt werden. Werte: us, eu, br. Erforderlich im Python-SDK v2.0.0+ und Java-SDK v2.0.0+; empfohlen in Node.js und .NET.
Allgemeine Muster
- Projektbezogener Schnellstart — Initialisieren Sie
SinchClientmit Projekt-Credentials. Siehe sprachspezifische Referenz. - Anwendungsbezogener Schnellstart — Initialisieren Sie
SinchClientmit App-Key/Secret. Siehe sprachspezifische Referenz. - Multi-Produkt-Client — Übergeben Sie beide Credential-Sets an eine einzige Client-Instanz.
- Regionale Conversation API — Setzen Sie
conversationRegionwährend der Initialisierung (erforderlich in Python/Java, empfohlen in anderen Fällen).
Fallstricke
- Nicht alle Produkte sind in allen SDKs verfügbar — Überprüfen Sie die Produktabdeckungstabelle, bevor Sie ein SDK empfehlen. Verwenden Sie für nicht unterstützte Produkte direkte HTTP-Aufrufe.
- Conversation-Region ist erforderlich — Python- und Java-SDKs schlagen zur Laufzeit ohne
conversation_regionfehl. Node.js und .NET erzwingen dies noch nicht, sollten es aber explizit setzen. - Voice/Verification verwenden Anwendungs-Credentials — Dies sind separate Credential-Sets von den Projekt-Access-Keys.
- SDKs aktualisieren OAuth2-Tokens automatisch — Keine manuelle Handhabung des Token-Ablaufs bei Verwendung der SDKs erforderlich.