Kuenta Docs

Appearance

Respuesta de voz Twilio para códigos TOTP​

GET
/twilio/configuration-org/{configuration-org-id}/entity/{entity-id}/user/{user-id}/document/{document-id}/signature/{signature-id}/code

Endpoint especializado para la entrega de códigos TOTP mediante respuesta de voz a través de Twilio.

Propósito de Accesibilidad:

  • Cumplimiento con regulaciones de accesibilidad (WCAG 2.1)
  • Soporte para usuarios con discapacidades visuales
  • Alternativa de voz para códigos SMS/Email

Flujo de Integración con Twilio:

  1. El usuario solicita código por llamada telefónica
  2. Sistema valida permisos y contexto de organización
  3. Twilio ejecuta webhook a este endpoint
  4. Se genera respuesta TwiML con código de voz
  5. Usuario escucha el código y lo ingresa en la aplicación

Validaciones de Seguridad:

  • Verificación de checksum para prevenir acceso no autorizado
  • Validación de contexto organizacional y de entidad
  • Control de rate limiting por usuario/documento
  • Verificación de vigencia del proceso de firma

Authorizations​

test

OAuth 2.0 Client Credentials Grant (RFC 6749 §4.4).
Utilice este flow para autenticación de aplicación-a-aplicación sin intervención del usuario.
Ideal para servicios backend y integración entre sistemas.

clientCredentials Flow
Token URLhttps://test-api.kuenta.co/v1/oauth/token
Scopes:
  • *Acceso completo (administrador)
  • users:readLectura de usuarios
  • users:writeEscritura de usuarios
  • users.info:writeEscritura de información de usuarios
  • clients:readLectura de clientes OAuth
  • clients:writeEscritura de clientes OAuth
  • verifications:writeEscritura de verificaciones
  • passwords:writeEscritura de contraseñas
  • keys:readLectura de claves
  • settings:readLectura de configuraciones
  • settings:writeEscritura de configuraciones
or
stage

OAuth 2.0 Client Credentials Grant (RFC 6749 §4.4).
Utilice este flow para autenticación de aplicación-a-aplicación sin intervención del usuario.
Ideal para servicios backend y integración entre sistemas.

clientCredentials Flow
Token URLhttps://stage-api.kuenta.co/v1/oauth/token
Scopes:
  • *Acceso completo (administrador)
  • users:readLectura de usuarios
  • users:writeEscritura de usuarios
  • users.info:writeEscritura de información de usuarios
  • clients:readLectura de clientes OAuth
  • clients:writeEscritura de clientes OAuth
  • verifications:writeEscritura de verificaciones
  • passwords:writeEscritura de contraseñas
  • keys:readLectura de claves
  • settings:readLectura de configuraciones
  • settings:writeEscritura de configuraciones
or
demo

OAuth 2.0 Client Credentials Grant (RFC 6749 §4.4).
Utilice este flow para autenticación de aplicación-a-aplicación sin intervención del usuario.
Ideal para servicios backend y integración entre sistemas.

clientCredentials Flow
Token URLhttps://demo-api.kuenta.co/v1/oauth/token
Scopes:
  • *Acceso completo (administrador)
  • users:readLectura de usuarios
  • users:writeEscritura de usuarios
  • users.info:writeEscritura de información de usuarios
  • clients:readLectura de clientes OAuth
  • clients:writeEscritura de clientes OAuth
  • verifications:writeEscritura de verificaciones
  • passwords:writeEscritura de contraseñas
  • keys:readLectura de claves
  • settings:readLectura de configuraciones
  • settings:writeEscritura de configuraciones

Parameters​

Path Parameters

configuration-org-id*

Identificador de configuración de la organización

Typestring
Required
Examplea1b2c3d4-e5f6-7890-1234-567890abcdef
formatuuid
entity-id*

Identificador de la entidad solicitante

Typestring
Required
Exampleb2c3d4e5-f607-8901-2345-67890abcdef1
formatuuid
user-id*

Identificador del usuario que solicita el código

Typestring
Required
Examplec3d4e5f6-0708-9012-3456-7890abcdef12
formatuuid
document-id*

Identificador único del documento en proceso de firma

Typestring
Required
Examplef47ac10b-58cc-4372-a567-0e02b2c3d479
formatuuid
signature-id*

Identificador único de la firma TOTP

Typestring
Required
Exampled4e5f607-a8b9-0123-4567-890abcdef123
formatuuid

Query Parameters

checksum*

Checksum de seguridad para validar la solicitud legítima

Typestring
Required
Example5d41402abc4b2a76b9719d911017c592
pattern^[a-f0-9]{32}$

Responses​

Respuesta TwiML generada exitosamente para entrega de voz
application/xml
XML

Playground​

Server
Authorization
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI