Zum Inhalt springen

Blockchain-API-FAQ für Entwickler

Diese FAQ beantwortet die häufigsten Entwicklerfragen zur Chaingateway-API: Authentifizierung, vorhandene Netzwerke, Tests, Fehlerantworten und Support. Chaingateway ist eine REST-API, mit der eine Anwendung Wallets erstellt, Transaktionen sendet, Blockchain-Daten liest und Webhooks empfängt. Jede Antwort verlinkt die Seite mit den Details.

Wenn eine Anfrage fehlschlägt: ok und status im JSON-Body lesen, dann message und errors, die Anfrage korrigieren oder den Support kontaktieren, wenn die Ursache auf Serverseite liegt Anfrage senden Authorization: Bearer YOUR_API_KEY ok und status im JSON-Body lesen ok: true heißt, der Aufruf hat funktioniert ok: false? message und errors lesen 401 Token oder Passwort, 422 Validierung oderGuthaben Anfrage korrigieren oder Supportkontaktieren support@chaingateway.io
Die Fehlerbehandlung, die die folgenden Antworten beschreiben.

Registrieren Sie ein Konto, erstellen Sie im Dashboard einen API-Key und senden Sie ihn als Bearer-Token. Die 7-tägige kostenlose Testphase braucht keine Karte. Der Schnellstart führt durch die erste Anfrage.

Was ist Chaingateway.io? Chaingateway.io ist eine Plattform, die Blockchain-API-Lösungen bereitstellt und Entwicklern erlaubt, Blockchain-Funktionen in ihre Anwendungen zu integrieren. Eine REST-Schnittstelle deckt Wallets, Transaktionen, Guthaben, Blöcke und Webhooks auf mehreren Blockchain-Netzwerken ab.

Wie fange ich mit Chaingateway.io an? Um zu starten, registrieren Sie sich für ein Konto auf Chaingateway.io. Nach der Registrierung können Sie im Dashboard unter API-Tokens einen API-Key erstellen. Sie benötigen ihn, um Ihre API-Anfragen zu authentifizieren. Die Dokumentation bietet Anleitungen und Beispiele, die Ihnen die Integration der API in Ihre Anwendung erleichtern.

Wie authentifiziere ich meine API-Anfragen? API-Anfragen an Chaingateway.io müssen mit einem API-Key authentifiziert werden. Erstellen Sie den Key nach dem Login im Dashboard. Senden Sie ihn als Bearer-Token in den Headern Ihrer HTTP-Anfragen:

Authorization: Bearer YOUR_API_KEY

Eine Anfrage ohne gültigen Token liefert HTTP 401 mit dem Body {"message":"Unauthenticated."}. Legen Sie den Key nicht in clientseitigem Code oder in einem Repository ab.

Gibt es Nutzungslimits für die APIs? Ja, es gibt Nutzungslimits, die vom Abonnement-Plan abhängen. Höherstufige Pläne bieten größere Nutzungskontingente. Detaillierte Informationen zu Limits und Preisen finden Sie auf unserer Preisseite. Wenn Sie zum Beispiel mehr Adressen erstellen, als Ihr Plan erlaubt, liefert die API Status 422 mit der Meldung Your address limit exceeded. Please upgrade your plan.

Die API unterstützt sieben Blockchains, jeweils mit Mainnet und Testnet, und bietet dort Wallet-Verwaltung, Transaktionsabwicklung, Webhooks und Datenabfrage. Unterstützte Netzwerke listet die Netzwerke und die Werte des Headers X-Network auf.

Welche Blockchain-Netzwerke werden unterstützt? Chaingateway.io unterstützt die folgenden Blockchain-Netzwerke:

  • Ethereum (Mainnet und Sepolia)
  • Binance Smart Chain (Mainnet und Testnet)
  • Bitcoin (Mainnet und Testnet3)
  • Polygon (Mainnet und Amoy)
  • Tron (Mainnet und Nile)
  • Arbitrum (Mainnet und Arbitrum Sepolia)
  • Solana (Mainnet und Devnet)

Weitere Informationen zum Zugriff auf die verschiedenen Netzwerke finden Sie unter Unterstützte Netzwerke.

Welche Arten von APIs bietet Chaingateway.io an? Die API deckt diese Bereiche ab:

  • Wallet-Verwaltung: Wallets erstellen und verwalten.
  • Transaktionsabwicklung: Native Coins und Token senden und Transaktionen lesen.
  • Instant Payment Notification: Webhook-Benachrichtigungen zu Blockchain-Ereignissen erhalten.
  • Datenabfrage: Blockchain-Daten wie Guthaben, Blöcke und Marktpreise abrufen.

Die OpenAPI-Datei listet mehr als 200 Operationen auf. Die API-Referenz dokumentiert jede davon.

Kann ich die APIs in einer Sandbox-Umgebung testen? Ja, jede unterstützte Blockchain hat ein Testnet. Fügen Sie einer Anfrage den Header X-Network: testnet hinzu, um sie im Testnetz auszuführen. Ohne den Header oder mit X-Network: mainnet läuft die Anfrage im Hauptnetz. So können Sie Ihre Integration testen, ohne echte Guthaben zu bewegen.

Unter Unterstützte Netzwerke steht, wie Sie auf die verschiedenen Netzwerke zugreifen.

Wie gehe ich mit Fehlern und Webhook-Ausfällen um?

Abschnitt betitelt „Wie gehe ich mit Fehlern und Webhook-Ausfällen um?“

Prüfen Sie bei jeder Antwort das Feld ok und protokollieren Sie message und errors, wenn es false ist. Fehlgeschlagene Webhook-Zustellungen werden nicht automatisch wiederholt. Sie listen sie auf und senden sie selbst erneut.

Wie gehe ich mit Fehlern der API um? Wenn eine API-Anfrage fehlschlägt, enthält die Antwort einen Status und eine Meldung, die das Problem angeben. Die OpenAPI-Datei dokumentiert diese Statuscodes:

  • 400: Bad Request. Beispiel: Der TRC20-Contract konnte nicht gelesen werden.
  • 401: Unauthorized. Der API-Key ist ungültig oder fehlt, oder das Wallet-Passwort ist falsch.
  • 404: Not Found. Beispiel: eine Webhook-ID, die nicht existiert.
  • 422: Unprocessable Entity. Die Anfrage war korrekt aufgebaut, aber die Validierung ist fehlgeschlagen oder die Blockchain hat die Transaktion abgelehnt, zum Beispiel wegen unzureichenden Guthabens.

Weitere Details finden Sie im Abschnitt zur Fehlerbehandlung in unserer Dokumentation. Wir fügen dem Response-Body außerdem nützliche Informationen hinzu. Hier ein Beispiel:

{
"status": 422,
"ok": false,
"message": "insufficient funds for gas * price + value: balance 2000000000000, tx cost 195000000000000, overshot 193000000000000",
"errors": []
}
{
"status": 422,
"ok": false,
"message": "Data validation failed",
"errors": {
"password": ["The password field is required."]
}
}

Wie werde ich über eingehende Zahlungen benachrichtigt? Erstellen Sie einen Webhook mit POST /api/v2/{chain}/webhooks. Chaingateway sendet dann für jede passende Transaktion eine HTTP-POST-Anfrage an Ihre URL. Webhooks gibt es für Ethereum, BNB Smart Chain, Polygon, Arbitrum, TRON und Bitcoin, aber nicht für Solana.

Eine fehlgeschlagene Zustellung wird nicht automatisch wiederholt. Listen Sie fehlgeschlagene Benachrichtigungen mit GET /api/v2/{chain}/webhooks/notifications/failed auf und senden Sie eine erneut mit POST /api/v2/{chain}/webhooks/notifications/{id}/retry. Siehe Webhooks und Webhook-Sicherheit.

Welchen Wallet-Typ sollte ich verwenden? Verwenden Sie für langlebige Adressen ein passwortgeschütztes Wallet. Sie senden beim Erstellen der Adresse ein password, und spätere Transaktionen werden mit diesem Passwort signiert. Verwenden Sie ein ungesichertes Wallet nur für temporäre Adressen, denn der Private Key wird in der Antwort zurückgegeben und Sie müssen ihn selbst speichern. Chaingateway speichert keine Passwörter und kann ein verlorenes nicht wiederherstellen. Siehe Wallet-Verwaltung.

Wo kann ich die Nutzung überwachen und Support erhalten?

Abschnitt betitelt „Wo kann ich die Nutzung überwachen und Support erhalten?“

Wie kann ich meine API-Nutzung überwachen? Sie können Ihre API-Nutzung über das Dashboard überwachen, das Analysen und Berichte zur Anzahl der gestellten Anfragen, zur Datennutzung und zu aufgetretenen Fehlern bereitstellt.

Wie erhalte ich Unterstützung bei Problemen? Für Support können Sie sich über unser im Dashboard verfügbares Support-Portal an uns wenden. Wir bieten außerdem ein Community-Forum und umfangreiche Dokumentation, die bei häufigen Problemen helfen können.

Bei dringenden Anliegen kontaktieren Sie unser Support-Team direkt per E-Mail unter support@chaingateway.io, über Telegram oder über den Webchat auf der Website.

Wir betreiben außerdem eine Telegram-Community, in der Sie nützliche Diskussionen finden.

Gibt es ein Empfehlungs- oder Partnerprogramm? Ja, wir bieten Empfehlungs- und Partnerprogramme für Entwickler und Unternehmen, die Chaingateway.io bewerben möchten. Weitere Informationen finden Sie auf unserer Partnerseite.

Wo finde ich die neuesten Updates und News zu Chaingateway.io?

Bleiben Sie mit den neuesten News, Feature-Releases und Ankündigungen auf dem Laufenden, indem Sie unserem Blog folgen und unseren Newsletter abonnieren.