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 y Organización

6 endpoint s

Gestiona usuarios, obtén /me y organización, actualiza perfiles y metadatos, invita miembros.

GET PATCH POST

Equipos

5 endpoint s

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

GET POST PATCH DELETE

Invitaciones

7 endpoint s

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

GET POST DELETE

Check-ins y Formularios

11 endpoint s

Crea y gestiona check-ins, explora plantillas y formularios, obtén respuestas.

GET POST PATCH DELETE

Mensajería

3 endpoint s

Envía mensajes a usuarios, equipos y canales. Envía emails y abre conversaciones.

POST

Kudos

4 endpoint s

Lista y envía kudos para reconocimiento del equipo.

GET POST PATCH

Workflows

8 endpoint s

Crea, gestiona y monitorea workflows automatizados y logs de ejecución.

GET POST PUT PATCH DELETE

API de Webhooks

3 endpoint s

Crea y gestiona suscripciones de webhooks y solicita payloads de ejemplo.

POST DELETE

Mood Tracking

2 endpoint s

Obtén y envía puntuaciones de ánimo para seguimiento de bienestar.

GET POST

Fechas Importantes

2 endpoint s

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

GET POST

Agent Reports

1 endpoint

Envía reportes de actividad desde bots y pipelines CI/CD.

POST

Commands Platform

10 endpoint s

Scheduling, storage, eventos, actividad y exchange tokens.

GET POST PUT DELETE

CLI

6 endpoint s

Autenticación CLI y envío de actualizaciones de check-in.

GET POST

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"