Passer au contenu principal
Une « demande (Application) » représente la relation d’abonnement du compte actuel à un service donné — vous devez d’abord créer 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 service, l’Application reçoit la valeur actuelle de free_amount 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, consultezObtenir 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 à l’appel réussi de leur première 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é au niveau du compte » permettant aux développeurs de gérer les ressources de leur propre compte via API. 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 via API : utilisez un jeton de compte existant ou le JWT de session de connexion 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 front-end ou dans des dépôts publics. En cas de fuite, supprimez-les immédiatement depuis 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 renvoyé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 passer par le processus de ticket pour demander l’ajout à la liste blanche.

Gestion des erreurs

Format unifié des réponses 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 recréer une Application du même type ne garantit pas qu’un quota gratuit sera attribué à nouveau.
  • Vérifiez le champ paid pour savoir si un paiement est requis : juste après la demande, paid=false, et il devient true après avoir appelé Créer une commande de recharge de la plateforme AceDataCloud pour effectuer le paiement.
  • disabled=true signifie qu’il 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 : obtenez d’abord le service_id cible à partir de la liste de services paginée, puis effectuez les demandes élément par élément selon les besoins métier ; lorsque vous rencontrez duplication, réutilisez l’Application existante.

Interfaces associées

allow_overdraft est désactivé par défaut et est autorisé séparément par un administrateur ; il ne peut pas être activé par vous-même via les paramètres de requête lors de la création d’une Application.