Autenticación

La API usa API keys secretas que se envían en la cabecera Authorization con el esquema Bearer:

curl https://api.sudte.com/v1/emitters \
  -H "Authorization: Bearer sk_test_51Hx..."

Pruebas y producción

El prefijo de la key define el ambiente del MH al que van tus documentos. No hay que enviar el ambiente en cada llamada.

Prefijo	Ambiente MH	Uso
`sk_test_`	`00` pruebas	Integración, pruebas mínimas para la autorización, demos. Sin valor legal y sin costo.
`sk_live_`	`01` producción	Documentos con validez tributaria. Cuentan para tu plan.

Los datos están separados por ambiente: una key de pruebas no ve documentos de producción, y viceversa. Cada emisor necesita sus credenciales del MH cargadas en el ambiente correspondiente; las de pruebas y las de producción son distintas.

Crear, limitar y revocar keys

Las keys se administran en el panel, en Desarrolladores. Al crear una key:

El secreto completo se muestra una sola vez. sudte guarda solo un hash y el prefijo visible (por ejemplo sk_live_a1b2).
Puedes limitarla a ciertos emisores (emitter_ids). Es la forma recomendada para casas de software que facturan por varios clientes: cada integración usa una key que solo puede emitir por su emisor.
Puedes ver la fecha de último uso y revocarla al instante.

Para rotar una key sin cortar el servicio: crea la nueva, despliégala en tu sistema y revoca la anterior cuando ya no tenga uso.

Errores de autenticación

Estado	`type`	Causa
`401`	`no-autenticado`	Falta la cabecera, la key no existe o fue revocada.
`403`	`prohibido`	La key no tiene acceso a ese emisor u operación.
`429`	`limite-excedido`	Superaste el límite de solicitudes; respeta `Retry-After`.

Otras cabeceras útiles

Idempotency-Key: obligatoria en todos los POST. Ver idempotencia.
Request-Id (respuesta): identificador de la solicitud. Inclúyelo cuando escribas a soporte; también aparece como request_id en los errores.