Entornos¶

La API expone una única base URL canónica para integraciones de cliente. Todos los ejemplos, recetas y snippets de esta documentación la usan.

Tabla de entornos¶

La base URL de producción se habilita como parte de tu proceso de onboarding. Tu contacto de Neuron te confirma el momento exacto en que queda disponible junto con tu API Key. Hasta entonces, puedes preparar tu integración usando esta URL como referencia.

Convención API_BASE_URL¶

Para que tu integración sea portable y fácil de mantener, define la base URL una sola vez como variable y reutilízala en cada request:

Bash

API_BASE_URL="https://api.neuronstudio.ai"

curl "$API_BASE_URL/api/agents" \
  -H "X-API-Key: nrn_live_abcdef1234567890abcdef1234567890"

Python

API_BASE_URL = "https://api.neuronstudio.ai"

import requests
resp = requests.get(
    f"{API_BASE_URL}/api/agents",
    headers={"X-API-Key": "nrn_live_abcdef1234567890abcdef1234567890"},
)

Centralizar la URL en API_BASE_URL te permite cambiar de entorno (cuando corresponda) en un solo lugar, sin tocar el resto del código.

La organización va implícita en la API Key¶

No existe un header de organización (no hay X-Tenant-ID ni similar). Tu API Key ya está vinculada a tu organización: todos los endpoints filtran automáticamente y solo devuelven datos de tu propia organización. Nunca vas a ver —ni puedes acceder a— datos de otro cliente.

Esto simplifica tu integración: alcanza con enviar la API Key en cada request (ver Autenticación).

Notas¶

• Usa siempre https://api.neuronstudio.ai en producción. No incrustes ninguna otra URL ni host de infraestructura en tu código.
• Toda la comunicación es sobre HTTPS. Las requests sobre HTTP no están soportadas.