Autenticación¶

Todas las operaciones de negocio requieren identificación mediante un API Key. Nuestro aplicativo rechaza peticiones no autenticadas o sin permiso.

Generar su API Key¶

Para generar su API Key ingrese al apartado de Configuración y a continuación al módulo de Llaves de acceso para integración. Seleccione generar nueva llave, los permisos necesarios para su configuración, y la fecha de expiración.

API Key¶

Envíe su clave en cada petición:

x-api-key: <su-api-key>

Versión de API¶

La versión fija el contrato de rutas y formatos. Cuando Kordata publique una nueva versión mayor, se actualizará esta documentación. Incluya tambien en los encabezados de cada petición la versión:

x-api-version: v1

La llave está asociada a su empresa en Kordata y determina:

Qué rutas puede invocar (permisos).
Ambiente para el que fue emitida.

Seguridad

No incluya la API Key en repositorios públicos, apps móviles descompilables ni logs.
Elimine y genere nuevas llaves si sospecha exposición; esto desde el modulo Llaves de acceso para integración en Kordata.
Use HTTPS siempre.

Probar llaves¶

En Referencia API:

Abra Authentication.
Seleccione ApiKeyAuth.
Ingrese su API Key y autorice las peticiones.