Disponibilidad del agente

GEThttps://api.bydomu.com/v1/booking/{slug}/availability

Días y horas libres del agente en un mes. configured: false si el agente no tiene horario. OJO: la respuesta viene doblemente envuelta, { data: { data: ... } }.

Permiso

portal:read

Claves

Publicable o secreta

Encabezados

X-API-Keystringobligatorio

Tu clave publicable o secreta.

Parámetros de ruta

slugstringobligatorio

Slug de la página de agendamiento del agente

Parámetros de consulta

monthinteger

Mes, de 0 (enero) a 11 (diciembre) · 0–11 · nullable

yearintegerobligatorio

Año (2020-2030) · 2020–2030

Respuestas

200Días con horas libres

400Datos inválidos: el cuerpo o la query no cumplen el esquema, o `Idempotency-Key` está mal formada.

401UNAUTHORIZED · Clave faltante, inválida, desactivada o vencida.

403FORBIDDEN · La clave no puede usar esta operación: falta el scope, es una secreta en el navegador, el nivel de la cuenta no la permite, está suspendida o se alcanzó un tope del plan.

404NOT_FOUND · El recurso no existe en la organización.

429RATE_LIMITED · Límite de peticiones excedido: el de la clave (`RATE_LIMITED`), el de escrituras de la organización (`TENANT_RATE_LIMITED`) o bloqueo temporal de la IP por claves inválidas.

500INTERNAL_ERROR · Error interno del servidor.

const url = new URL("https://api.bydomu.com/v1/booking/carlos-rodriguez/availability"); url.searchParams.set("year", "1"); const res = await fetch(url, { headers: { "X-API-Key": process.env.BYDOMU_API_KEY }, }); const data = await res.json();

import os, requests r = requests.get( "https://api.bydomu.com/v1/booking/carlos-rodriguez/availability", params={"year": "1"}, headers={"X-API-Key": os.environ["BYDOMU_API_KEY"]} ) data = r.json()

{ "data": { "data": { "availableDates": [ { "date": "2026-10-05", "slots": [ "09:00" ] } ], "configured": true } } }