free_amount configurado actualmente para ese servicio; este valor puede ser 0.
ℹ️ Esta interfaz pertenece a la API de administración de la plataforma AceDataCloud, con el prefijo unificado https://platform.acedata.cloud/api/v1/. Para el índice completo de interfaces, consulte Obtener la lista de documentos de la plataforma AceDataCloud.
Flujo completo de integración
Los nuevos usuarios, desde el registro hasta lograr conectar la primera interfaz de negocio, normalmente siguen estos 5 pasos:- Obtener el token de cuenta → Administrar tokens de cuenta de la plataforma AceDataCloud
- Elegir un servicio → Obtener la lista de servicios de la plataforma AceDataCloud
- Crear una solicitud(este documento) → Obtener la cuota inicial según la configuración del servicio
- Crear credenciales de API → Crear credenciales de API de la plataforma AceDataCloud
- Llamar a la interfaz de negocio → Usar el Token de 32 caracteres obtenido para llamar a
https://api.acedata.cloud/<path>
Resumen de la interfaz
Instrucciones de autenticación(cómo obtener el token de cuenta)
Encabezado de la solicitud:- Creación con un clic en la consola(recomendado): Inicie sesión en la plataforma AceDataCloud → Consola de Account Token → Haga clic en «Crear» para obtener un token que comienza con
platform-v1-. - Creación mediante API: Use un token de cuenta existente o el JWT de sesión del navegador para llamar a
POST /api/v1/platform-tokens/; consulte Administrar tokens de cuenta de la plataforma AceDataCloud para más detalles.
⚠️ El token de cuenta es tan sensible como una contraseña; está prohibido escribirlo en código frontend o repositorios públicos. Si se filtra, elimínelo y vuelva a crearlo inmediatamente en la consola.
Cuerpo de la solicitud
Ejemplo de solicitud
cURL
Python
Node.js
Ejemplo de respuesta
Éxito(HTTP 201)
Ya solicitado(HTTP 400)
El servicio no existe(HTTP 404)
El servicio requiere revisión(HTTP 403)
need_verify=true(este campo puede verse en la lista de servicios), debe seguir el proceso de ticket para solicitar la inclusión en la lista blanca.
Manejo de errores
Formato unificado de respuesta de error:
Consejos prácticos
- La creación en sí no genera cargos: al crear por primera vez, la cuota inicial se establece según el
free_amountactual del servicio; este valor puede ser 0, y crear nuevamente una Application del mismo tipo no garantiza que se otorgue el regalo de nuevo. - Si se requiere pago depende del campo
paid: justo después de la solicitud,paid=false; después de llamar a Crear pedido de recarga de la plataforma AceDataCloud y completar el pago, cambia atrue. disabled=trueindica que ha sido deshabilitado temporalmente—por ejemplo, por activación de control de riesgos, pagos pendientes, etc. Cuando está deshabilitado, la interfaz de negocio devolverá403.- No cree de forma concurrente sin límites: primero obtenga el
service_idobjetivo de la lista paginada de servicios y luego solicítelos uno por uno según las necesidades del negocio; cuando encuentreduplication, reutilice la Application existente.
Interfaces relacionadas
- Obtener lista de servicios de la plataforma AceDataCloud — primero elija un servicio
- Obtener lista de solicitudes de servicios de la plataforma AceDataCloud — ver todas las solicitudes realizadas
- Obtener detalles de la solicitud de servicio de la plataforma AceDataCloud — ver una solicitud individual
- Crear credencial de API de la plataforma AceDataCloud — siguiente paso después de solicitar con éxito
- Crear pedido de recarga de la plataforma AceDataCloud — recargar después de agotar la cuota gratuita

