Autenticación
Para garantizar la seguridad y privacidad de tus datos, nuestra API requiere autenticación para cada solicitud.
La autenticación se puede realizar de dos maneras:
Incluyendo una clave de API (API Key) en el encabezado de tu solicitud.
Usando tres encabezados distintos (headers), método que se aplica si estás intentando integrar una nueva aplicación (APP) con Darwin.
Método de Clave de API (API Key Method)
Obtener tu Clave de API
Tu clave de API única es proporcionada directamente por el equipo de Darwin.
Esta clave actúa como un token de acceso seguro a tu cuenta y debe mantenerse confidencial.
No compartas tu clave de API públicamente ni con personas no autorizadas.
Si no has recibido tu clave de API o la has perdido, por favor contacta a nuestro equipo de soporte en [email protected] para recibir asistencia.
Usar tu Clave de API
Para autenticar tus solicitudes a la API, incluye tu clave de API en el encabezado de cada solicitud usando el campo X-API-KEY.
Aquí tienes un ejemplo de cómo incluir tu clave de API en una solicitud usando cURL:
curl -X GET 'https://api.getdarwin.ai/endpoint' \ -H 'X-API-KEY: TuClaveDeAPIAquí'
Reemplaza TuClaveDeAPIAquí con tu clave real proporcionada por el equipo de Darwin.
Método de Clave de APP (APP Key Method)
Obtener tu APP Key y APP Secret
Si estás intentando integrar una nueva aplicación (APP) con Darwin, deberás obtener una APP Key y un APP Secret.
Estas claves son proporcionadas directamente por el equipo de Darwin y actúan como tokens de acceso seguro para tu aplicación.
Debes mantenerlas confidenciales y no compartirlas públicamente ni con personas no autorizadas.
Si no has recibido tus credenciales (APP Key y APP Secret) o las has perdido, contacta al equipo de soporte en [email protected] para obtener ayuda.
Usar tu APP Key y APP Secret
Deberás enviar tres encabezados (headers) en tu solicitud para autenticar las peticiones de tu aplicación:
X-APP-KEY
X-SIGNATURE
X-AGENT-ID
Para generar el valor de X-SIGNATURE, necesitarás usar tu APP Key, tu APP Secret y el payload de la solicitud.
Aquí tienes un ejemplo de cómo hacerlo:
const crypto = require('crypto'); const payload = JSON.stringify(request.body); const signature = crypto.createHmac('sha256', 'your_app_secret') .update('your_app_key' + payload) .digest('hex');