Preparación
- Inicie sesión en la plataforma AceDataCloud.
- Cree un token de cuenta en la consola de Account Token.
- Los usuarios normales usan
user_id=me; también puede obtener su propio UUID desdeGET /api/v1/platform-tokens/me/.
Resumen de la interfaz
Los usuarios normales deben pasar
user_id=me. Si no se pasa, la consulta no se restringe primero por cuenta, y la paginación puede devolver 403 al encontrar objetos sin autorización; los administradores pueden ver la tabla completa si no lo pasan.
Parámetros de consulta
paid, disabled, expired, low_balance y tag actualmente no son parámetros de filtrado del servidor. Las alertas de saldo deben obtener la lista y luego evaluarse en el cliente según remaining_amount, service.unit y el umbral de negocio de cada Application.
Ejemplo de solicitud
Descripción de la respuesta
La respuesta es{count, items}. Cada elemento contiene los campos del modelo Application y añade:
service:id,alias,title,type,unit,icon_url;credentials: el resumen de credenciales que el llamador actual tiene permiso para ver;paid,remaining_amount,used_amount,disabled,allow_consume_global,allow_overdraft;- el valor real de
scopeesIndividualoGlobal; - el valor real de
typeesUsageoPeriod.
allow_overdraft es un campo booleano de solo lectura controlado por el administrador, con valor predeterminado false. Para las aplicaciones por uso (Usage) con sobregiro habilitado, un saldo insuficiente no impedirá las llamadas y se seguirá cobrando según el uso real; un saldo negativo representa una cuota pendiente de liquidación. La desactivación, el vencimiento y los límites de las credenciales de API siguen vigentes.
remaining_amount puede estar vacío; el cliente debe comprobar primero si es nulo antes de realizar comparaciones numéricas. La unidad de cuota se determina mediante service.unit.

