Skip to main content
«Solicitud (Application)» representa la relación de suscripción de la cuenta actual a un servicio determinado; primero debe solicitarse, para luego poder crear credenciales de API para esta solicitud y llamar a las interfaces de negocio. Al solicitar un servicio por primera vez, 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, desde el registro hasta lograr conectar la primera interfaz de negocio, normalmente siguen estos 5 pasos:
  1. Obtener el token de cuenta → Administrar tokens de cuenta de la plataforma AceDataCloud
  2. Elegir 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. Formas de obtenerlo:
  1. 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-.
  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 vuelva a crearlo inmediatamente en la consola.

Cuerpo de la solicitud

Ejemplo de solicitud

cURL

Python

Node.js

Ejemplo de respuesta

Éxito(HTTP 201)

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

Ya solicitado(HTTP 400)

Esta es una restricción estricta por diseño: cada usuario solo puede tener una Application para cada servicio. Si ya existe, encuentre 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 servicio tiene 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_amount actual 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 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 de forma concurrente sin límites: 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