Ir al contenido

Verificar la API key

Devuelve la empresa emisora y el entorno de la API key usada. Úsalo para comprobar que tu integración se conecta bien y si tu empresa ya está lista para producción.

Ventana de terminal
curl https://faktura-test.cgallardo.me/v1/me -H "Authorization: Bearer sk_test_..."

Método: GET

GET https://faktura-test.cgallardo.me/v1/me
{
"company": {
"id": "01a1d52b-90eb-7207-b415-4e3f2ba3f9bd",
"ruc": "20000000001",
"legal_name": "FAKTURA BETA S.A.C.",
"trade_name": null,
"has_certificate": true,
"has_sol_credentials": true,
"certificate_valid_until": "2027-11-13T23:59:59+00:00"
},
"api_key": { "prefix": "sk_test_ec829766c02e", "environment": "test", "scope": "full", "expires_at": null },
"sunat_environment": "beta"
}
Campo Descripción
company.has_certificate Tu certificado digital ya está cargado.
company.has_sol_credentials Tu usuario SOL secundario ya está configurado. Ambos son necesarios para emitir con una clave live.
company.certificate_valid_until Vencimiento de tu certificado digital (null si no hay). Renuévalo antes: vencido, la firma deja de ser válida y SUNAT rechaza los envíos.
api_key.environment test o live.
api_key.scope full (emitir y consultar) o lookup (solo consultas de RUC y DNI).
api_key.expires_at Vencimiento de la clave (null si no vence). Los accesos de prueba vencen: desde ese momento toda llamada responde 401 y hay que pedir otra clave.
sunat_environment beta o production: adónde se envían los comprobantes de esta clave.
Estado reason Significado
200 — Devuelve los datos del emisor y de la API key.
401 Unauthenticated Falta la API key, es inválida, fue revocada o venció.
429 TooManyRequests Superaste las 120 peticiones por minuto.