tverificas.
DocumentaciónIr al dashboard →
Empieza acá

Autenticación.

Cada request a la API lleva tu API key en la cabecera Authorization. No hay OAuth, sesiones ni refresh tokens — un solo secreto, simple de manejar.

Tipos de key

Cada organización tiene dos tipos:

  • tvk_live_… — producción. Cobra contra la cuota mensual de la organización.
  • tvk_test_… — sandbox. Sin costo, corre contra el límite de modo test (50 verificaciones por defecto).

Crea, lista y revoca keys desde la sección API Keys de tu dashboard.

Cabecera

http
Authorization: Bearer tvk_live_xxxxxxxxxxxxx

Verifica que tu key funciona

curlbash
curl https://api.tverificas.com/v1/me \
  -H "Authorization: Bearer $TVERIFICAS_API_KEY"

Si la key es válida, el endpoint devuelve los datos de tu organización y el tipo de key (live o test).

Variable de entorno recomendada

.envbash
TVERIFICAS_API_KEY=tvk_live_xxxxxxxxxxxxx

Buenas prácticas

  • Nunca subas la key al repositorio. Usa variables de entorno o un secret manager.
  • Empieza siempre integrando con una key test.
  • Rota la key live periódicamente: crea una nueva, despliega, revoca la anterior.
  • Una key por entorno (staging, producción) — facilita rotaciones sin downtime.
  • Si una key se filtra, revócala desde el dashboard de inmediato.