Referencia de API

La API de MyGPTAssistants te permite integrar capacidades de chat con IA en tus aplicaciones. REST API

Visión General

URL Base

https://api.mygptassistants.com/v1

Autenticación

Portador de Token (API Key)

Authorization: Bearer YOUR_API_KEY

Inicio Rápido

const response = await fetch('https://api.mygptassistants.com/v1/bot/YOUR_BOT_ID', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    message: 'Hola, ¿cómo puedo ayudarte?',
    sessionId: 'user-session-123'
  })
});

const data = await response.json();
console.log(data.response);

import requests

response = requests.post(
    'https://api.mygptassistants.com/v1/bot/YOUR_BOT_ID',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'message': 'Hola, ¿cómo puedo ayudarte?',
        'sessionId': 'user-session-123'
    }
)

data = response.json()
print(data['response'])

curl -X POST https://api.mygptassistants.com/v1/bot/YOUR_BOT_ID \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Hola, ¿cómo puedo ayudarte?",
    "sessionId": "user-session-123"
  }'

Endpoints Disponibles

Autenticación Gestiona claves API y permisos de acceso

API de Chat Envía mensajes, recibe respuestas, gestiona sesiones

Webhooks Recibe notificaciones en tiempo real de eventos

Límites de Tasa

Cabecera	Descripción
`X-RateLimit-Limit`	Máximo de solicitudes por minuto
`X-RateLimit-Remaining`	Solicitudes restantes en la ventana actual
`X-RateLimit-Reset`	Marca de tiempo cuando se reinicia el límite

Códigos de Error

Código	Significado
`200`	Éxito
`400`	Solicitud inválida - revisa tus parámetros
`401`	No autorizado - clave API inválida o faltante
`403`	Prohibido - permisos insuficientes
`404`	No encontrado - recurso no existe
`429`	Demasiadas solicitudes - límite de tasa excedido
`500`	Error del servidor - inténtalo de nuevo más tarde

Formato de Respuesta

Todas las respuestas son JSON:

{
  "success": true,
  "data": {
    // Datos de respuesta aquí
  },
  "error": null
}

Respuestas de error:

{
  "success": false,
  "data": null,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "Descripción del error"
  }
}

SDKs y Librerías

JavaScript/TypeScript

npm install @mygptassistants/sdk

Python

pip install mygptassistants