Obtenir les enregistrements d’appels Proxy de la plateforme AceDataCloud

Interrogez les enregistrements d’utilisation du compte actuel sous les services de type Proxy. Pour les appels API ordinaires, veuillez utiliser les enregistrements d’appels API. Si vous n’êtes pas certain du type de service, vous pouvez d’abord consulter le type dans les détails du service.

Préparatifs

Connectez-vous à la plateforme AceDataCloud.
Créez un jeton de compte dans la console Account Token, et enregistrez-le immédiatement dans un gestionnaire de mots de passe ou un Secret Manager.
Ouvrez la page de profil pour copier l’UUID du compte actuel, et enregistrez-le comme USER_ID. Le user_id dans la réponse de création du jeton de compte peut également être utilisé.
Obtenez l’application_id du service de type Proxy depuis la liste des demandes de service. Lorsqu’un filtrage par point de terminaison Proxy est nécessaire, obtenez le proxy_id depuis la liste des Proxy sous le service.

Consultez gérer les jetons de compte pour les instructions complètes sur les jetons. Cette interface utilise un Account Token, et non le Credential utilisé pour appeler l’API métier.

export PLATFORM_TOKEN='votre jeton de compte'
export USER_ID='votre UUID de compte'
export APPLICATION_ID='votre ID d’application Proxy'

Aperçu de l’interface

Élément	Contenu
Méthode	`GET`
URL	`https://platform.acedata.cloud/api/v1/usage/proxies/`
Authentification	`Authorization: Bearer ${PLATFORM_TOKEN}`
Scope	`usage:read`
Pagination	`count` + `items`, 10 éléments par page par défaut

Lorsque le propriétaire de l’Application effectue une requête avec application_id, le serveur synchronise d’abord les enregistrements disponibles de cette Application, puis renvoie la liste ; le temps de réponse peut donc être plus long que celui d’une liste d’utilisation API ordinaire. Les utilisateurs autorisés peuvent lire les enregistrements visibles existants, mais ne déclenchent pas la synchronisation côté propriétaire.

Paramètres de requête

Paramètre	Type	Obligatoire pour les utilisateurs ordinaires	Par défaut	Description
`user_id`	UUID	Oui	—	UUID du compte actuel ; un autre compte renvoie `403`
`application_id`	UUID	Recommandé	—	Filtre par Proxy Application ; prend en charge les paramètres répétés
`proxy_id`	UUID	Non	—	Filtre par point de terminaison Proxy ; prend en charge les paramètres répétés
`limit`	integer	Non	10	Nombre d’éléments par page, maximum 100
`offset`	integer	Non	0	Décalage de pagination
`ordering`	string	Non	`-created_at`	Ordre décroissant par heure de création

L’interface actuelle ne prend pas en charge le filtrage direct par modèle, code d’état HTTP, Credential ou plage temporelle, et ne prend pas non plus en charge le paramètre perspective de l’interface d’utilisation API. N’ajoutez pas ces paramètres non pris en charge à la requête en supposant qu’ils ont pris effet.

Exemple de requête

curl --get 'https://platform.acedata.cloud/api/v1/usage/proxies/' \
  --data-urlencode "user_id=${USER_ID}" \
  --data-urlencode "application_id=${APPLICATION_ID}" \
  --data-urlencode 'limit=100' \
  --data-urlencode 'ordering=-created_at' \
  -H "Authorization: Bearer ${PLATFORM_TOKEN}"

Exemple de pagination Python :

import os
import requests

response = requests.get(
    "https://platform.acedata.cloud/api/v1/usage/proxies/",
    headers={"Authorization": f"Bearer {os.environ['PLATFORM_TOKEN']}"},
    params={
        "user_id": os.environ["USER_ID"],
        "application_id": os.environ["APPLICATION_ID"],
        "limit": 100,
    },
    timeout=60,
)
response.raise_for_status()
data = response.json()

for usage in data["items"]:
    print(usage["created_at"], usage["deducted_amount"], usage["remaining_amount"])

Exemple de réponse

{
  "count": 1,
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000001",
      "user_id": "00000000-0000-4000-8000-000000000002",
      "actor_user_id": null,
      "application_id": "00000000-0000-4000-8000-000000000003",
      "proxy_id": "00000000-0000-4000-8000-000000000004",
      "credential_id": null,
      "used_amount": null,
      "deducted_amount": 1.25,
      "remaining_amount": 98.75,
      "metadata": null,
      "created_at": "2026-09-01T08:00:00Z",
      "updated_at": "2026-09-01T08:00:00Z",
      "service": {
        "id": "00000000-0000-4000-8000-000000000005",
        "title": "Example Proxy Service"
      },
      "credential": null
    }
  ]
}

Champs clés

Champ	Description
`user_id`	Compte qui supporte cette déduction
`actor_user_id`	Appelant réel ; les anciens enregistrements peuvent être vides
`application_id`	Proxy Application ayant généré cet enregistrement
`proxy_id`	Point de terminaison Proxy correspondant
`credential_id`	ID du Credential associé ; les anciens enregistrements peuvent être vides
`used_amount`	Utilisation de l’enregistrement d’origine ; peut être vide
`deducted_amount`	Montant finalement déduit
`remaining_amount`	Solde d’Application restant après la déduction
`metadata`	Métadonnées publiques ; peuvent être vides
`service` / `credential`	Résumés des objets associés pour faciliter l’affichage ; peuvent être vides lorsque les objets associés n’existent pas

L’unité de quota est déterminée par service.unit de l’Application correspondante.

Gestion des erreurs

HTTP	Signification	Méthode de traitement
401	Jeton de compte manquant ou invalide	Vérifiez l’Account Token, n’utilisez pas par erreur le Credential métier
403	Pas autorisé à consulter les enregistrements demandés	Utilisez l’Application du compte actuel, supprimez le `user_id` non autorisé
5xx	Échec temporaire de synchronisation ou de requête	Conservez les conditions de filtrage et réessayez avec un délai progressif ; en cas d’échec continu, fournissez l’ID d’Application et l’heure au support

Étape suivante

Consulter les enregistrements d’appels API : interrogez les détails des services de type API ordinaire.
Obtenir la liste des Proxy sous le service : obtenez le proxy_id.
Consulter les détails de la demande de service : confirmez le quota restant et l’unité.

Démarrage

Chat IA

Image IA

Vidéo IA

Audio IA

Web & Données

CAPTCHA

Identité

Coding

Autres guides

Obtenir les enregistrements d’appels Proxy de la plateforme AceDataCloud

Préparatifs

Aperçu de l’interface

Paramètres de requête

Exemple de requête

Exemple de réponse

Champs clés

Gestion des erreurs

Étape suivante

​Préparatifs

​Aperçu de l’interface

​Paramètres de requête

​Exemple de requête

​Exemple de réponse

​Champs clés

​Gestion des erreurs

​Étape suivante

Préparatifs

Aperçu de l’interface

Paramètres de requête

Exemple de requête

Exemple de réponse

Champs clés

Gestion des erreurs

Étape suivante