Autenticación

Todas las solicitudes de API requieren autenticación mediante claves API. Requerido

Generando Claves API

Inicia sesión en tu panel de control

Ve a panel.mygptassistants.com
Navega a Configuración de API

Haz clic en Configuración → API en la barra lateral.
Haz clic en “Generar Nueva Clave”

Elige un nombre descriptivo para tu clave.
Configura los permisos

Selecciona qué acciones puede realizar esta clave.
Copia tu clave de forma segura

Tu clave API solo se muestra una vez. Cópiala inmediatamente y guárdala de forma segura. Si la pierdes, deberás generar una nueva.

Usando tu Clave API

Incluye tu clave API en la cabecera Authorization:

const response = await fetch('https://api.mygptassistants.com/v1/chat/send', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    bot_id: 'your-bot-id',
    message: 'Hola'
  })
});

import requests

headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
}

response = requests.post(
    'https://api.mygptassistants.com/v1/chat/send',
    headers=headers,
    json={'bot_id': 'your-bot-id', 'message': 'Hola'}
)

curl -X POST https://api.mygptassistants.com/v1/chat/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bot_id": "your-bot-id", "message": "Hola"}'

Mejores Prácticas de Seguridad

Nunca Expongas Claves

Nunca commits claves API al control de versiones

Usa variables de entorno o gestores de secretos.

Usa Mínimos Privilegios

Solo otorga los permisos necesarios

Crea claves con alcance limitado para diferentes servicios.

Rota Regularmente

Regenera claves periódicamente

Configura una rotación programada de claves.

Monitorea el Uso

Rastrea la actividad de las claves API

Revisa los logs para accesos no autorizados.

Permisos de Clave API

Permiso	Descripción
`chat:send`	Enviar mensajes a bots
`chat:read`	Leer historial de conversaciones
`chat:stream`	Usar respuestas en streaming
`bots:read`	Listar y ver bots
`bots:write`	Crear y modificar bots
`analytics:read`	Acceder a datos analíticos
`webhooks:manage`	Configurar webhooks

Rotación de Claves

Genera una nueva clave

Crea una nueva clave API con los mismos permisos.
Actualiza tus aplicaciones

Despliega la nueva clave en tu código.
Prueba minuciosamente

Verifica que todo funcione con la nueva clave.
Revoca la clave antigua

Una vez confirmado, elimina la clave antigua.

Errores de Autenticación

Error	Causa	Solución
`401 Unauthorized`	Clave faltante o inválida	Verifica que tu clave sea correcta
`403 Forbidden`	Permisos insuficientes	Revisa los permisos de la clave
`429 Too Many Requests`	Límite de tasa excedido	Implementa backoff exponencial

Temas Relacionados

Visión General de la API Introducción general a la API

API de Chat Endpoints de chat y ejemplos