Saltar al contenido principal
Una «solicitud (Application)» representa la relación de suscripción de la cuenta actual a un determinado servicio; primero debe solicitarlo para poder crear credenciales de API para esta solicitud y llamar a las interfaces de negocio. Al solicitar un servicio por primera vez, la Application obtendrá el 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:
  1. Obtener el token de cuenta → Administrar tokens de cuenta de la plataforma AceDataCloud
  2. Seleccionar un servicio → Obtener la lista de servicios de la plataforma AceDataCloud
  3. Crear una solicitud (este documento) → Obtener la cuota inicial según la configuración del servicio
  4. Crear credenciales de API → Crear credenciales de API de la plataforma AceDataCloud
  5. 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:
El token de cuenta (Account Token) es la «clave a nivel de cuenta» que los desarrolladores usan para administrar los recursos de su propia cuenta mediante la API. Métodos de obtención:
  1. 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-.
  2. 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)

La estructura de los campos devueltos es coherente con Obtener los detalles de la solicitud de servicio de la plataforma AceDataCloud.

Ya solicitado (HTTP 400)

Esta es una limitación estricta del diseño: cada usuario solo puede tener una Application para cada servicio. Si ya existe, busque la existente mediante Obtener la lista de solicitudes de servicio de la plataforma AceDataCloud.

El servicio no existe (HTTP 404)

El servicio requiere revisión (HTTP 403)

Si el 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_amount actual 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 paid para 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 a true.
  • disabled=true indica 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_id objetivo de la lista paginada de servicios, y luego solicítelos uno por uno según las necesidades del negocio; cuando encuentre duplication, reutilice la Application existente.

Interfaces relacionadas

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.