Skip to main content
Une « demande (Application) » représente la relation d’abonnement du compte actuel à un certain service — vous devez d’abord faire une demande, avant de pouvoir créer des identifiants API pour cette demande et appeler les interfaces métier. Lors de la première demande d’un certain service, l’Application obtient la valeur free_amount actuellement configurée pour ce service ; cette valeur peut être 0.
ℹ️ Cette interface appartient à l’API de gestion de la plateforme AceDataCloud, avec le préfixe unifié https://platform.acedata.cloud/api/v1/. Pour l’index complet des interfaces, consultez Obtenir la liste de la documentation de la plateforme AceDataCloud.

Processus d’intégration complet

Les nouveaux utilisateurs suivent généralement ces 5 étapes, de l’inscription jusqu’au premier appel d’interface métier :
  1. Obtenir le jeton de compte → Gérer les jetons de compte de la plateforme AceDataCloud
  2. Choisir un service → Obtenir la liste des services de la plateforme AceDataCloud
  3. Créer une demande (ce document) → Obtenir le quota initial selon la configuration du service
  4. Créer des identifiants API → Créer des identifiants API de la plateforme AceDataCloud
  5. Appeler l’interface métier → Utiliser le Token de 32 caractères obtenu pour appeler https://api.acedata.cloud/<path>

Aperçu de l’interface

Instructions d’authentification (comment obtenir le jeton de compte)

En-tête de requête :
Le jeton de compte (Account Token) est une « clé de niveau compte » que les développeurs utilisent via l’API pour gérer les ressources de leur propre compte. Méthodes d’obtention :
  1. Création en un clic depuis la console (recommandée) : connectez-vous à la plateforme AceDataCloud → console Account Token → cliquez sur « Créer » pour obtenir un jeton commençant par platform-v1-.
  2. Création par API : utilisez un jeton de compte existant ou le JWT de session du navigateur pour appeler POST /api/v1/platform-tokens/, voir Gérer les jetons de compte de la plateforme AceDataCloud.
⚠️ Les jetons de compte sont aussi sensibles que les mots de passe ; il est interdit de les écrire dans le code frontend ou dans des dépôts publics. En cas de fuite, supprimez-les immédiatement dans la console et recréez-les.

Corps de la requête

Exemples de requête

cURL

Python

Node.js

Exemples de réponse

Succès (HTTP 201)

La structure des champs retournés est identique à celle de Obtenir les détails d’une demande de service de la plateforme AceDataCloud.

Déjà demandé (HTTP 400)

Il s’agit d’une restriction stricte par conception : chaque utilisateur ne peut avoir qu’une seule Application pour chaque service. Si elle existe déjà, recherchez celle existante via Obtenir la liste des demandes de service de la plateforme AceDataCloud.

Service introuvable (HTTP 404)

Le service nécessite une vérification (HTTP 403)

Si le service a need_verify=true (ce champ est visible dans la liste des services), vous devez suivre le processus de ticket pour demander l’ajout à la liste blanche.

Gestion des erreurs

Format unifié de réponse d’erreur :

Conseils pratiques

  • La création elle-même n’entraîne aucun débit : lors de la première création, le quota initial est défini selon le free_amount actuel du service ; cette valeur peut être 0, et créer à nouveau une Application du même type ne garantit pas l’attribution répétée du quota gratuit.
  • Vérifiez le champ paid pour savoir si un paiement est requis : juste après la demande, paid=false ; après avoir appelé Créer une commande de recharge de la plateforme AceDataCloud et terminé le paiement, il devient true.
  • disabled=true signifie que le service est temporairement désactivé — par exemple, en cas de déclenchement du contrôle des risques, d’impayé, etc. Lorsqu’il est désactivé, l’interface métier renvoie 403.
  • Ne créez pas de manière concurrente sans limite : récupérez d’abord le service_id cible depuis la liste paginée des services, puis demandez-les un par un selon les besoins métier ; en cas de duplication, réutilisez l’Application existante.

Interfaces associées