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 normalmente siguen estos 5 pasos desde el registro hasta la conexión de su primera interfaz de negocio:- Obtener el token de cuenta → Administrar tokens de cuenta de la plataforma AceDataCloud
- Seleccionar 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 desde 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 créelo de nuevo inmediatamente desde la consola.
Cuerpo de la solicitud
Ejemplos de solicitud
cURL
Python
Node.js
Ejemplos 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 del servicio (este campo puede verse en la lista de servicios), debe seguir el proceso de ticket para solicitar la lista blanca.
Manejo de errores
Formato unificado de respuesta de error:
Consejos prácticos
- La creación en sí no realiza cargos: al crear por primera vez, se establece la cuota inicial 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 otra vez. - Consulte el campo
paidpara saber si se requiere pago: justo después de solicitarlo,paid=false; después de llamar a Crear orden 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 con concurrencia ilimitada: 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 la lista de servicios de la plataforma AceDataCloud — primero elija un servicio
- Obtener la lista de solicitudes de servicio de la plataforma AceDataCloud — ver todas las solicitudes realizadas
- Obtener los detalles de una solicitud de servicio de la plataforma AceDataCloud — ver una sola solicitud
- Crear credenciales API de la plataforma AceDataCloud — el siguiente paso después de una solicitud exitosa
- Crear orden de recarga de la plataforma AceDataCloud — recargar después de agotar la cuota gratuita
allow_overdraft está desactivado de forma predeterminada y es autorizado por separado por un administrador; no puede activarse por cuenta propia mediante parámetros de solicitud al crear una Application.
