Vorbereitung
- Melden Sie sich bei der AceDataCloud-Plattform an.
- Erstellen Sie in der Account-Token-Konsole ein Konto-Token.
- Normale Benutzer verwenden
user_id=me; Sie können auch Ihre eigene UUID überGET /api/v1/platform-tokens/me/abrufen.
Schnittstellenübersicht
Normale Benutzer sollten
user_id=me übergeben. Wenn es nicht übergeben wird, wird die Abfrage nicht zuerst nach Konto eingeschränkt, und bei der Paginierung kann bei nicht berechtigten Objekten 403 zurückgegeben werden; Administratoren können ohne Angabe die gesamte Tabelle anzeigen.
Abfrageparameter
paid, disabled, expired, low_balance und tag sind derzeit keine serverseitigen Filterparameter. Für Guthabenwarnungen sollte nach dem Abrufen der Liste auf Clientseite anhand von remaining_amount, service.unit und Geschäftsschwellenwerten jedes Application entschieden werden.
Anfragebeispiele
Antwortbeschreibung
Die Antwort lautet{count, items}. Jeder Eintrag enthält die Application-Modellfelder sowie zusätzlich:
service:id,alias,title,type,unit,icon_url;credentials: Zusammenfassung der Zugangsdaten, die der aktuelle Aufrufer sehen darf;paid,remaining_amount,used_amount,disabled,allow_consume_global,allow_overdraft;- der tatsächliche Wert von
scopeistIndividualoderGlobal; - der tatsächliche Wert von
typeistUsageoderPeriod.
allow_overdraft ist ein schreibgeschütztes boolesches Feld, das von Administratoren gesteuert wird und standardmäßig false ist. Bei nutzungsbasierten (Usage) Applications mit aktiviertem Überziehen verhindert unzureichendes Guthaben keine Aufrufe; die Abrechnung erfolgt weiterhin gemäß der tatsächlichen Nutzung. Ein negatives Guthaben stellt ein noch abzurechnendes Kontingent dar. Deaktivierung, Ablauf und API-Zugangsdatenlimits bleiben weiterhin wirksam.
remaining_amount kann leer sein; der Client muss zuerst auf Leerwerte prüfen, bevor numerische Vergleiche durchgeführt werden. Die Kontingenteinheit wird durch service.unit bestimmt.

