Zum Hauptinhalt springen
Gibt paginiert Applications zurück, die das Konto besitzt oder zur Nutzung autorisiert wurde, einschließlich Guthaben, Status, Service-Zusammenfassung und zugehörigen Zugangsdaten. Geeignet für die Überwachung von Guthaben in Stapelverarbeitung, das Finden von Application IDs und den Zugriff auf die Zugangsdatenverwaltung.

Vorbereitung

  1. Melden Sie sich bei der AceDataCloud-Plattform an.
  2. Erstellen Sie in der Account-Token-Konsole ein Konto-Token.
  3. Normale Benutzer verwenden user_id=me; Sie können auch Ihre eigene UUID über GET /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

Gleichzeitig Applications anzeigen, die Ihnen selbst gehören und die andere Ihnen autorisiert haben:

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 scope ist Individual oder Global;
  • der tatsächliche Wert von type ist Usage oder Period.
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.

Nächste Schritte