Autorización API

Esta guía explica cómo obtener la clave de autenticación necesaria para utilizar las APIs de Neoagent.

Cómo Obtener la Clave Secreta

Para acceder a las APIs de Neoagent, necesitas una clave de autenticación única. Sigue estos pasos para recuperarla:

Paso 1: Ve a la Configuración

Accede a tu cuenta de Neoagent y navega a la Configuración de tu perfil.

Paso 2: Selecciona Webhooks API

Una vez en la configuración, encuentra y selecciona la sección "Webhooks API".

Paso 3: Recupera la Clave

Desplázate hasta el final de la página de Webhooks API. Aquí encontrarás tu Token Management.

Uso de la Clave Secreta

Una vez que hayas obtenido la clave, utilízala en todas las solicitudes API en el encabezado Authorization:

Authorization: Your-Secret-Key
Content-Type: application/json

Ejemplo de Uso

JavaScript

const headers = {
  'Authorization': 'your-secret-key-here',
  'Content-Type': 'application/json'
};

const response = await fetch('https://app.neoagent.co/api/endpoint', {
  method: 'POST',
  headers: headers,
  body: JSON.stringify(data)
});

Python

headers = {
    'Authorization': 'your-secret-key-here',
    'Content-Type': 'application/json'
}

response = requests.post(
    'https://app.neoagent.co/api/endpoint',
    headers=headers,
    json=data
)

cURL

curl -X POST \
  'https://app.neoagent.co/api/endpoint' \
  -H 'Authorization: your-secret-key-here' \
  -H 'Content-Type: application/json' \
  -d '{"key": "value"}'

Seguridad de la Clave

Importante

• Nunca compartas tu Clave Secreta públicamente
• No incluyas la clave en el código frontend visible para los usuarios
• Regenera la clave si sospechas que ha sido comprometida
• Usa variables de entorno para almacenar la clave en tus proyectos

Mejores Prácticas para la Seguridad

1. Variables de Entorno: Almacena la clave en variables de entorno

   const apiKey = process.env.NEOAGENT_SECRET_KEY;

2. Solo del Lado del Servidor: Usa la clave solo en llamadas del lado del servidor, nunca en el frontend

3. Monitoreo: Monitorea el uso de tu API para detectar actividades sospechosas

4. Rotación: Considera regenerar periódicamente la clave para mayor seguridad

Resolución de Problemas

Error 401 - No Autorizado

Si recibes un error 401, verifica que:

• La Clave Secreta sea correcta
• El encabezado Authorization esté presente
• No haya espacios extra en la clave

Error 403 - Prohibido

Si recibes un error 403, podría ser que:

• Tu cuenta no tiene los permisos necesarios
• Has superado los límites de limitación de tasas
• El endpoint solicitado no está disponible para tu plan