Disponibilidad del agente

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

Esta referência é gerada a partir do código da API, por isso as descrições estão em espanhol. Nomes, parâmetros e exemplos são iguais em qualquer idioma.

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: ... } }.

Permissão
portal:read
Chaves
Publicável ou secreta

Cabeçalhos

X-API-Keystringobrigatório
Sua chave publicável ou secreta.

Parâmetros de rota

slugstringobrigatório
Slug de la página de agendamiento del agente

Parâmetros de consulta

monthinteger
Mes, de 0 (enero) a 11 (diciembre) · 0–11 · nullable
yearintegerobrigatório
Año (2020-2030) · 2020–2030

Respostas

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.
cURL
curl -G "https://api.bydomu.com/v1/booking/carlos-rodriguez/availability" \
  -H "X-API-Key: $BYDOMU_API_KEY" \
  --data-urlencode "year=1"
JavaScript
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();
Python
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()
Resposta · 200 · exemplo
{
  "data": {
    "data": {
      "availableDates": [
        {
          "date": "2026-10-05",
          "slots": [
            "09:00"
          ]
        }
      ],
      "configured": true
    }
  }
}

A chave vai na variável BYDOMU_API_KEY. Os dados do exemplo não são de nenhuma imobiliária.