Passer au contenu principal
Renvoie de manière paginée les Applications détenues par le compte ou dont l’utilisation est autorisée, y compris le solde, le statut, le résumé du service et les identifiants associés. Convient à la surveillance groupée des soldes, à la recherche d’Application ID et à l’accès à la gestion des identifiants.

Préparatifs

  1. Connectez-vous à la plateforme AceDataCloud.
  2. Créez un jeton de compte dans la console Account Token.
  3. Les utilisateurs ordinaires utilisent user_id=me ; vous pouvez également obtenir votre propre UUID depuis GET /api/v1/platform-tokens/me/.

Aperçu de l’interface

Les utilisateurs ordinaires doivent transmettre user_id=me. Sans cela, la requête n’est pas d’abord restreinte par compte, et la pagination peut renvoyer 403 lorsqu’elle rencontre des objets non autorisés ; les administrateurs peuvent consulter toute la table sans le transmettre.

Paramètres de requête

paid, disabled, expired, low_balance et tag ne sont actuellement pas des paramètres de filtrage côté serveur. Les alertes de solde doivent récupérer la liste, puis déterminer côté client selon remaining_amount, service.unit et les seuils métier de chaque Application.

Exemple de requête

Consulter simultanément les Applications que vous détenez et celles que d’autres vous ont autorisé à utiliser :

Description de la réponse

La réponse est {count, items}. Chaque élément contient les champs du modèle Application, et ajoute :
  • service : id, alias, title, type, unit, icon_url ;
  • credentials : le résumé des identifiants que l’appelant actuel est autorisé à voir ;
  • paid, remaining_amount, used_amount, disabled, allow_consume_global, allow_overdraft ;
  • la valeur réelle de scope est Individual ou Global ;
  • la valeur réelle de type est Usage ou Period.
allow_overdraft est un champ booléen en lecture seule contrôlé par l’administrateur, avec une valeur par défaut de false. Pour les applications à l’usage (Usage) dont le découvert est activé, un solde insuffisant ne bloque pas les appels et la facturation s’effectue toujours selon l’utilisation réelle ; un solde négatif représente un montant en attente de règlement. La désactivation, l’expiration et les limites des identifiants API restent applicables. remaining_amount peut être vide ; le client doit d’abord vérifier qu’il n’est pas vide avant d’effectuer une comparaison numérique. L’unité du quota est déterminée par service.unit.

Étapes suivantes