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:- Kontotoken erhalten → AceDataCloud-Plattform-Kontotoken verwalten
- Dienst auswählen → AceDataCloud-Plattformdienstliste abrufen
- Antrag erstellen (dieses Dokument) → Anfangskontingent gemäß Dienstkonfiguration erhalten
- API-Anmeldedaten erstellen → AceDataCloud-Plattform-API-Anmeldedaten erstellen
- 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:- 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. - 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)
Bereits beantragt (HTTP 400)
Dienst nicht vorhanden (HTTP 404)
Dienst erfordert Überprüfung (HTTP 403)
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_amountdes 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
paidab: Direkt nach der Beantragung istpaid=false; nach dem Aufruf von AceDataCloud-Plattform-Aufladeauftrag erstellen und Abschluss der Zahlung wird es zutrue. disabled=truebedeutet, dass es vorübergehend deaktiviert wurde—zum Beispiel durch Auslösung der Risikokontrolle, Zahlungsrückstände usw. Bei Deaktivierung gibt die Geschäftsschnittstelle403zurück.- Keine unbegrenzte parallele Erstellung: Zuerst die Ziel-
service_idaus der paginierten Dienstliste abrufen und dann je nach Geschäftsbedarf einzeln beantragen; beiduplicationdie vorhandene Application wiederverwenden.
Zugehörige Schnittstellen
- AceDataCloud-Plattform-Dienstliste abrufen — zuerst einen Dienst auswählen
- Liste der AceDataCloud-Plattform-Dienstbeantragungen abrufen — alle bereits beantragten anzeigen
- Details einer AceDataCloud-Plattform-Dienstbeantragung abrufen — einzelne Beantragung anzeigen
- AceDataCloud-Plattform-API-Anmeldeinformationen erstellen — nächster Schritt nach erfolgreicher Beantragung
- AceDataCloud-Plattform-Aufladeauftrag erstellen — nach Aufbrauch des kostenlosen Kontingents aufladen
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.
