Referencia API

La API REST de Dailybot te permite gestionar check-ins, usuarios, equipos, mensajes y más de forma programática. Todos los endpoints aceptan y devuelven JSON, usan métodos HTTP estándar y requieren autenticación por API key.

URL Base

Todas las peticiones API usan la siguiente URL base:

text

https://api.dailybot.com/v1/

Autenticación Requerida

Cada petición debe incluir tu API key en el header X-API-KEY. Consulta la página de Autenticación para más detalles.

Recursos

La API está organizada en los siguientes recursos. Haz clic en un recurso para ver todos los endpoints disponibles, parámetros y ejemplos de respuesta.

Usuarios

5 endpoints

Consulta el directorio de la org, obtén perfiles de usuario y actualiza metadata.

GETPATCH

Organización

1 endpoint

Consulta la organización a la que está limitada la credencial actual.

GET

Equipos

7 endpoints

Lista equipos, gestiona membresía, agrega o remueve miembros.

GETPOSTPATCHDELETE

Invitaciones

6 endpoints

Invita usuarios (plataforma o guest), lista y gestiona invitaciones pendientes.

GETPOSTPUTDELETE

Check-ins

14 endpoints

Crea, configura y archiva check-ins; gestiona preguntas, horario, participantes y respuestas.

GETPOSTPATCHPUTDELETE

Formularios

15 endpoints

Crea, configura y archiva formularios; gestiona preguntas, flujo de trabajo y respuestas.

GETPOSTPATCHPUTDELETE

Canales de reporte

1 endpoint

Lista canales de chat disponibles para reportes en formularios y check-ins.

GET

Plantillas

2 endpoints

Consulta plantillas pre-construidas de check-in con variables renderizadas.

GET

Mensajería

3 endpoints

Envía mensajes del bot a usuarios, equipos y canales; envía emails; abre conversaciones.

POST

Kudos

4 endpoints

Da kudos, lista kudos, stats a nivel de org, leaderboard del muro de fama.

GETPOST

Mood Tracking

1 endpoint

Registra entradas de mood del equipo como señal de bienestar.

POST

Fechas Importantes

2 endpoints

Lista y consulta fechas importantes (cumpleaños, aniversarios).

GET

Workflows

5 endpoints

Crea, consulta, actualiza y elimina workflows automatizados.

GETPOSTPATCHDELETE

Webhooks

2 endpoints

Crea suscripciones de webhooks y solicita payloads de ejemplo.

POST

Agentes

14 endpoints

Superficie completa del agente: reports, health, messages, email, webhook, claim y auto-registro.

GETPOSTDELETE

OAuth2

2 endpoints

Endpoints de autorización y token para apps de terceros.

GETPOST

Integraciones

2 endpoints

Callbacks de eventos y webhooks usados por integraciones de primera parte.

POST

Commands Platform

14 endpoints

Scheduling, storage, suscripciones de eventos, feed de actividad, exchange tokens.

GETPOSTPUTDELETE

CLI (auth)

7 endpoints

Endpoints CLI-only de autenticación OTP y estado.

GETPOST

Patrones Comunes

Paginación

La mayoría de endpoints de listado usan paginación limit/offset. Usa limit (por defecto 250, máx 250) y offset para navegar. Algunos endpoints (ej. invitaciones pendientes) usan paginación por página con page y page_size (máx 100).

Códigos de Error

La API usa códigos de estado HTTP estándar:

Código	Estado	Descripción
200	OK	Petición exitosa
201	Created	Recurso creado exitosamente
204	No Content	Petición exitosa, sin cuerpo de respuesta
400	Bad Request	Cuerpo o parámetros de petición inválidos
401	Unauthorized	API key faltante o inválida
403	Forbidden	Permisos insuficientes
404	Not Found	Recurso no encontrado
429	Too Many Requests	Límite de tasa excedido
500	Server Error	Error interno del servidor

Formato de respuesta de error

Los errores devuelven un cuerpo JSON con detail (mensaje legible) y code (código máquina). Algunos incluyen extra para contexto. Si hay rate limit (429), la respuesta incluye el header Retry-After.

Límites de tasa

Peticiones autenticadas: 60 peticiones/minuto. Peticiones anónimas: 30 peticiones/minuto.

Formato de Petición

Todas las peticiones deben incluir los siguientes headers:

Headers estándar de petición

curl -X GET "https://api.dailybot.com/v1/{endpoint}/" \
  -H "X-API-KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json"