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.
curl https://faktura-test.cgallardo.me/v1/me -H "Authorization: Bearer sk_test_..."use Illuminate\Support\Facades\Http;
$response = Http::withToken('sk_test_...') ->get('https://faktura-test.cgallardo.me/v1/me');
$data = $response->json();const response = await fetch('https://faktura-test.cgallardo.me/v1/me', { headers: { Authorization: 'Bearer sk_test_...', },});const data = await response.json();Método: GET
Endpoint
Sección titulada «Endpoint»GET https://faktura-test.cgallardo.me/v1/meGET https://faktura.cgallardo.me/v1/meRespuesta 200 OK
Sección titulada «Respuesta 200 OK»{ "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. |
Respuestas y errores
Sección titulada «Respuestas y errores»| 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. |