Zum Hauptinhalt springen
„Antrag (Application)“ bezeichnet die Abonnementbeziehung des aktuellen Kontos zu einem Dienst — Sie müssen zuerst einen Antrag stellen, bevor Sie für diesen Antrag API-Anmeldedaten erstellen und Geschäftsschnittstellen aufrufen können. Beim erstmaligen Beantragen eines Dienstes erhält die Application den aktuell für diesen Dienst konfigurierten Wert free_amount; dieser Wert kann 0 sein.
ℹ️ Diese Schnittstelle gehört zur AceDataCloud-Plattformverwaltungs-API mit dem einheitlichen Präfix https://platform.acedata.cloud/api/v1/. Den vollständigen Schnittstellenindex finden Sie unter AceDataCloud-Plattformdokumentliste abrufen.

Vollständiger Integrationsablauf

Neue Benutzer durchlaufen von der Registrierung bis zum erfolgreichen Aufruf der ersten Geschäftsschnittstelle in der Regel diese 5 Schritte:
  1. Kontotoken erhalten → AceDataCloud-Plattform-Kontotoken verwalten
  2. Dienst auswählen → AceDataCloud-Plattformdienstliste abrufen
  3. Antrag erstellen (dieses Dokument) → Anfangskontingent gemäß Dienstkonfiguration erhalten
  4. API-Anmeldedaten erstellen → AceDataCloud-Plattform-API-Anmeldedaten erstellen
  5. Geschäftsschnittstelle aufrufen → Mit dem erhaltenen 32-stelligen Token https://api.acedata.cloud/<path> aufrufen

Schnittstellenübersicht

Hinweise zur Authentifizierung (wie man ein Kontotoken erhält)

Request-Header:
Das Kontotoken (Account Token) ist der „Schlüssel auf Kontoebene“, über den Entwickler ihre eigenen Kontoressourcen per API verwalten. Methoden zum Erhalt:
  1. Erstellung mit einem Klick in der Konsole (empfohlen): Melden Sie sich bei der AceDataCloud-Plattform an → Account-Token-Konsole → Klicken Sie auf „Erstellen“, um ein Token zu erhalten, das mit platform-v1- beginnt.
  2. Erstellung per API: Rufen Sie mit einem vorhandenen Kontotoken oder dem JWT des Browser-Anmeldestatus POST /api/v1/platform-tokens/ auf. Details finden Sie unter AceDataCloud-Plattform-Kontotoken verwalten.
⚠️ Kontotoken sind genauso sensibel wie Passwörter und dürfen nicht in Frontend-Code oder öffentliche Repositories geschrieben werden. Löschen und erstellen Sie sie bei einer Offenlegung sofort in der Konsole neu.

Request-Body

Request-Beispiele

cURL

Python

Node.js

Antwortbeispiele

Erfolg (HTTP 201)

Die Struktur der zurückgegebenen Felder entspricht der von Details zum AceDataCloud-Plattformdienstantrag abrufen.

Bereits beantragt (HTTP 400)

Dies ist eine harte Einschränkung im Design: Jeder Benutzer kann pro Dienst nur eine Application haben. Wenn sie bereits existiert, suchen Sie die vorhandene über AceDataCloud-Plattformdienstantragsliste abrufen.

Dienst nicht vorhanden (HTTP 404)

Dienst erfordert Überprüfung (HTTP 403)

Wenn für den Dienst need_verify=true gilt (dieses Feld ist in der Dienstliste sichtbar), müssen Sie den Ticketprozess durchlaufen, um die Whitelist zu beantragen.

Fehlerbehandlung

Einheitliches Format der Fehlerantwort:

Praktische Hinweise

  • Die Erstellung selbst verursacht keine Kosten: Bei der ersten Erstellung wird das anfängliche Kontingent gemäß dem aktuellen free_amount des Dienstes festgelegt; dieser Wert kann 0 sein, und bei einer erneuten Erstellung einer gleichartigen Application ist eine erneute Gewährung nicht garantiert.
  • Ob eine Zahlung erforderlich ist, hängt vom Feld paid ab: Direkt nach der Beantragung ist paid=false; nach dem Aufruf von AceDataCloud-Plattform-Aufladeauftrag erstellen und Abschluss der Zahlung wird es zu true.
  • disabled=true bedeutet, dass es vorübergehend deaktiviert wurde—zum Beispiel durch Auslösung der Risikokontrolle, Zahlungsrückstände usw. Bei Deaktivierung gibt die Geschäftsschnittstelle 403 zurück.
  • Keine unbegrenzte parallele Erstellung: Zuerst die Ziel-service_id aus der paginierten Dienstliste abrufen und dann je nach Geschäftsbedarf einzeln beantragen; bei duplication die vorhandene Application wiederverwenden.

Zugehörige Schnittstellen

allow_overdraft ist standardmäßig deaktiviert und wird separat vom Administrator autorisiert; bei der Erstellung einer Application kann es nicht über Anfrageparameter selbst aktiviert werden.