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 :- Obtenir le jeton de compte → Gérer les jetons de compte de la plateforme AceDataCloud
- Choisir un service → Obtenir la liste des services de la plateforme AceDataCloud
- Créer une demande (ce document) → Obtenir le quota initial selon la configuration du service
- Créer des identifiants API → Créer des identifiants API de la plateforme AceDataCloud
- 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 :- 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-. - 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)
Déjà demandé (HTTP 400)
Service introuvable (HTTP 404)
Le service nécessite une vérification (HTTP 403)
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_amountactuel 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
paidpour savoir si un paiement est requis : juste après la demande,paid=false, et il devienttrueaprès avoir appelé Créer une commande de recharge de la plateforme AceDataCloud pour effectuer le paiement. disabled=truesignifie 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 renvoie403.- Ne créez pas de manière concurrente sans limite : obtenez d’abord le
service_idcible à partir de la liste de services paginée, puis effectuez les demandes élément par élément selon les besoins métier ; lorsque vous rencontrezduplication, réutilisez l’Application existante.
Interfaces associées
- Obtenir la liste des services de la plateforme AceDataCloud — choisir d’abord un service
- Obtenir la liste des demandes de services de la plateforme AceDataCloud — consulter toutes les demandes déjà effectuées
- Obtenir les détails d’une demande de service de la plateforme AceDataCloud — consulter une demande individuelle
- Créer des identifiants API de la plateforme AceDataCloud — étape suivante après le succès de la demande
- Créer une commande de recharge de la plateforme AceDataCloud — recharger après épuisement du quota gratuit
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.
