API pública: primeros pasos

La API pública conecta tus sistemas con Grupos Inteligentes. Puedes consultar datos y automatizar tareas sin repetir acciones en el panel.

Antes de comenzar

Necesitarás:

acceso a tu cuenta de Grupos Inteligentes;
una suscripción Scale activa;
un lugar seguro para guardar el token;
una herramienta capaz de realizar solicitudes HTTPS.

Un token de API funciona como una contraseña exclusiva para la integración. Permite que otro sistema acceda a los datos de tu cuenta.

Cómo crear un token

Entra en la aplicación de Grupos Inteligentes.
Abre Configuración en el menú lateral.
Selecciona Tokens de API.
Haz clic en Crear token.
Escribe un nombre que identifique la integración.
Confirma con Crear.
Copia el token y guárdalo inmediatamente.

Usa nombres claros, como Automatización de informes o Integración del CRM.

Consejo: Guarda el token en un gestor de contraseñas o secretos. Nunca lo pongas en una página pública, aplicación de navegador o archivo compartido.

Haz tu primera solicitud

La dirección base de la API es:

https://api.gruposinteligentes.com/api

Envía el token en el encabezado Authorization, precedido por la palabra Bearer.

curl --request GET \
  --url https://api.gruposinteligentes.com/api/v1/redirectors \
  --header "Accept: application/json" \
  --header "Authorization: Bearer $GI_API_TOKEN"

En el ejemplo, GI_API_TOKEN es una variable segura de tu sistema. No la reemplaces con un token real en código compartido.

Para solicitudes que envían datos, añade también este encabezado:

Content-Type: application/json

Encuentra la operación correcta

Abre la referencia completa de la API para consultar:

las direcciones disponibles;
los campos aceptados por cada solicitud;
ejemplos de respuestas;
los posibles códigos de error.

La referencia muestra ejemplos con el encabezado Authorization. Por seguridad, ejecuta estos ejemplos en tu propia herramienta.

Límites y validez

Cada token acepta hasta 60 solicitudes por minuto.
Cada token muestra su propia fecha de vencimiento en el panel.
Los tokens vencidos o revocados dejan de funcionar inmediatamente.
Los tokens de integración no pueden crear, listar o revocar otros tokens.

Crea un token nuevo antes de que venza el actual. Después, actualiza tu integración y revoca el antiguo.

Cómo revocar un token

Revoca un token perdido, expuesto o que ya no uses:

Abre Configuración en la aplicación.
Selecciona Tokens de API.
Encuentra el token por su nombre.
Haz clic en Revocar y confirma.

La integración pierde el acceso a tu cuenta en cuanto confirmas.

Errores comunes

Código	Qué significa	Cómo resolverlo
`401`	El token no es válido, venció o fue revocado	Crea un token y actualiza la integración
`403`	Tu plan actual no permite usar tokens	Activa o renueva el plan Scale
`422`	Falta un campo o es incorrecto	Revisa los campos en la referencia de la API
`429`	Demasiadas solicitudes en poco tiempo	Espera y reduce la frecuencia de solicitudes

Si todavía necesitas ayuda, escribe a suporte@gruposinteligentes.com.