Consulta por páginas las llamadas de negocio registradas para las claves API de la cuenta.
Un administrador de cuenta revisa registrado API llamadas por clave, endpoint y fecha. Los registros de uso devueltos ayudan al administrador a identificar qué llamadas pertenecen al período que se revisa.
Un analista de finanzas revisa los cargos registrados por negocios API El analista comprueba cada estado de llamada devuelta y el campo de crédito cargado en lugar de inferir cargos desde el tiempo de procesamiento.
Un desarrollador llama al punto final de uso de la cuenta desde un panel interno usando un usuario API clave. El panel muestra la información de la cuenta devuelta sin necesidad de una exportación manual.
Devuelve las llamadas a la API registradas para las claves de la cuenta de Nexscope. Los resultados corresponden al período solicitado. Consulta las tablas para conocer el significado de cada campo. Los cargos pendientes pueden aparecer más tarde y cada consulta usa su propia instantánea.
La consulta es gratuita y cuesta 0 créditos. Lee los datos contabilizados sin registrar una llamada de negocio. Puedes usar este GET gratuito con un saldo de cero o negativo. Los dos endpoints de cuenta comparten un límite de 60 solicitudes por cuenta cada 60 segundos.
Envía una solicitud GET a /api/skill-api/v1/account/usage con una clave API de usuario GENERAL en el encabezado Authorization: Bearer. Introduce las fechas y los datos de paginación opcionales como parámetros de consulta. La tabla describe el intervalo de tiempo en UTC. La consulta requiere una clave API de usuario. Los tokens de sesión y las claves de complementos carecen de autorización.
Consulta por páginas las llamadas de negocio registradas para las claves API de la cuenta.
GET /api/skill-api/v1/account/usageEnvía una clave de API de usuario GENERAL en la cabecera Authorization Bearer. Los JWT del sitio web, las claves de plugins y los tokens de instalación no pueden llamar a este endpoint. Un saldo cero o negativo no bloquea este GET gratuito.
Authorization: Bearer YOUR_API_KEYLee datos confirmados de la cuenta sin consumir créditos ni añadir una llamada de API de negocio. Ambas consultas comparten un límite de 60 solicitudes por cuenta cada 60 segundos.
/api/skill-api/v1/account/usage| Método | GET |
| Ruta | /api/skill-api/v1/account/usage |
| Autenticación | Bearer API key |
| Cuerpo de la solicitud | Ninguno. Los parámetros opcionales son campos de consulta. |
2026-04-28T20:26:40.000Z → 1777408000000; 2026-05-28T20:26:40.000Z → 1780000000000.
curl -H "Authorization: Bearer YOUR_API_KEY" "https://api.nexscope.ai/api/skill-api/v1/account/usage?startTime=1777408000000&endTime=1780000000000&pageNum=1&pageSize=20"La API usa milisegundos desde la época UTC. En la prueba en línea, introduce la fecha y hora UTC; el área de pruebas convierte esos campos UTC a milisegundos sin usar la zona horaria del navegador. Sin fechas, se usan los 30 días anteriores. Si se proporciona un solo límite, el otro se completa con un intervalo de 30 días o la hora actual. La ventana es [startTime, endTime), no puede superar 180 días ni terminar en el futuro.
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
endTime | string | opcional | Opcional UTC milisegundos, exclusiva. La ventana debe terminar a más tardar en el momento de la solicitud. |
pageNum | integer | opcional | Número de página basado en una sola. Predeterminado: 1 Mínimo: 1 |
pageSize | integer | opcional | Filas por página. Predeterminado: 20 Mínimo: 1 Máximo: 100 |
startTime | string | opcional | Opcional UTC milisegundos época, inclusive. Introduzca fecha y hora UTC en el probador; el API recibe una cadena decimal de milisegundos. |
Sobre ResponseData completo. cost es el tiempo de procesamiento en milisegundos, no los créditos cobrados.
{
"code": 0,
"msg": null,
"data": {
"scope": "API_KEY_CALLS",
"observedAt": "1780000000000",
"startTime": "1777408000000",
"endTime": "1780000000000",
"grossChargedCredit": "8",
"calls": {
"records": [
{
"id": "1",
"createTime": "1779999999000",
"apiKeyId": "2",
"path": "/api/skill-api/v1/skills/example/run",
"method": "POST",
"callResult": "SUCCESS",
"chargeStatus": "CHARGED",
"chargedCredit": "8",
"requestId": "example-request",
"correlationRequestId": "example-diagnostic-id",
"latencyMs": 120
}
],
"total": "1",
"size": "20",
"current": "1",
"pages": "1"
}
},
"ts": "1780000000000",
"time": "2026-05-28 20:26:40",
"cost": "13",
"traceId": null
}Los créditos Int64, los ID, los totales de páginas y las horas desde la época son cadenas decimales; los estados enteros y los campos de latencia siguen siendo números JSON. Los campos opcionales pueden ser null o estar ausentes si hay un error.
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
code | integer | opcional | Código de resultado de negocio. Sólo 0 significa éxito, incluso cuando HTTP es 200. |
cost | string | opcional | Solicitar duración del procesamiento en milisegundos, no créditos. -1 significa contexto no-Web. |
data | object | null | opcional | Cuenta API Uso clave de llamada de negocios en caso de éxito; nulo en caso de error. |
data.calls | object | opcional | Página de llamadas de negocios, ordenadas por registro de identificación descendente; consultas de cuenta gratuitas están excluidas. |
data.calls.current | string | opcional | Número actual de página basado en una sola, cadena decimal. |
data.calls.pages | string | opcional | Conteo de páginas calculado, cadena decimal. |
data.calls.records | array | opcional | Registros de llamadas en esta página, incluyendo llamadas fallidas, rechazadas y no cargadas. |
data.calls.records[] | object | obligatorio | Elemento de data calls records. |
data.calls.records[].apiKeyId | string | null | opcional | Llamando API ID de clave, cadena decimal o null para una llamada rechazada sin una clave identificada. |
data.calls.records[].callResult | string | opcional | Resultado de la llamada de negocios, incluyendo solicitudes rechazadas y fallidas. Permitidos: SUCCESS, FAILED, REJECTED |
data.calls.records[].chargeStatus | string | null | opcional | Estado de la carga grabada (por ejemplo, CHARGED, SKIPPED, FAILED, o NOT_CHARGED), o null. |
data.calls.records[].chargedCredit | string | null | opcional | Créditos realmente cargados por esta llamada, cadena decimal o null. |
data.calls.records[].correlationRequestId | string | null | opcional | ID generado por el servidor compartido con diagnósticos de llamadas de herramientas. Utilice este ID para la búsqueda de diagnóstico; null para registros heredados. |
data.calls.records[].createTime | string | null | opcional | Llamar tiempo de creación en milisegundos de época UTC, o nulo. |
data.calls.records[].id | string | opcional | API Clave de llamada de registro ID, cadena decimal. |
data.calls.records[].latencyMs | integer | null | opcional | Llame a latencia en milisegundos, o nulo. |
data.calls.records[].method | string | null | opcional | Método HTTP grabado, o nulo. |
data.calls.records[].path | string | null | opcional | Ruta de solicitud grabada, o nula. |
data.calls.records[].requestId | string | null | opcional | Identificación original de la solicitud del cliente, o null. Esto puede ser reutilizado a través de las llamadas. |
data.calls.size | string | opcional | Tamaño de página solicitado, cadena decimal. |
data.calls.total | string | opcional | Registros de llamadas coincidentes totales, cadena decimal. |
data.endTime | string | opcional | Exclusivo UTC actual de época-millisegundo final de la ventana. |
data.grossChargedCredit | string | opcional | Suma de los saldos reales chargedCredit para llamadas de negocios CHARGED antes de reembolsos; cadena decimal. |
data.observedAt | string | opcional | UTC milisegundos época cuando se observó este dato-comprometido leído. |
data.scope | string | opcional | API Ámbito clave de las llamadas de negocios, no el libro mayor de cuentas completo o la actividad JWT. Permitidos: API_KEY_CALLS |
data.startTime | string | opcional | Actual incluido UTC época-millisegundo inicio ventana. |
msg | string | null | opcional | Mensaje comercial opcional; puede ser nulo u omitido en el éxito. |
time | string | opcional | Tiempo de respuesta con formato de servidor (aaaa-mm-dd HH:mm:ss); su zona no está especificada por este campo. |
traceId | string | null | opcional | ID opcional de seguimiento de errores; puede ser nulo u omitido en caso de éxito. |
ts | string | opcional | Marca de tiempo de respuesta del servidor, milisegundos de época UTC como cadena decimal. |
| HTTP 200 | Comprueba ResponseData.code: solo 0 indica un resultado de negocio correcto. Un código distinto de cero puede llegar con HTTP 200. |
| HTTP 400 | Una ventana de tiempo o parámetros de paginación no válidos devuelven un error de parámetros. |
| HTTP 401 / 403 | La clave falta, no es válida o no tiene acceso. |
| HTTP 429 | Protección de frecuencia compartida para consultas de cuenta; Retry-After: 60 segundos. |
| HTTP 5xx | Error del servicio o de una dependencia; reintenta según el estado devuelto. |
grossChargedCredit suma las llamadas de negocio con clave de API cobradas antes de reembolsos, no todo el consumo del libro de cuenta. calls incluye llamadas de negocio fallidas, rechazadas y sin cobro, pero excluye consultas gratuitas de cuenta y actividad JWT.
observedAt indica la hora de lectura. Solo aparecen resultados confirmados; los cargos en curso pueden aparecer más tarde. Las consultas independientes no comparten una instantánea y las páginas de uso pueden cambiar al completarse las llamadas.
Envía una solicitud GET real y gratuita de tu cuenta con tu clave de API de usuario. No se envía ninguna solicitud hasta que selecciones Ejecutar API.