Pular para o conteúdo

Primeiros passos

Da primeira leitura ao primeiro agendamento no negócio de teste, em cinco chamadas.

Atualizado em 10 de outubro de 2026

Antes de começar

A API pública não pede conta nem chave. Todas as chamadas abaixo usam a base https://agendria.com.br/api/v1 e o negócio de teste sandbox-agendria. As reservas dele são reais, mas ficam isoladas: não ocupam horário de ninguém, não mandam mensagem e não geram Pix nem cobrança.

  • Dinheiro chega em centavos, com currency BRL.
  • Datas seguem ISO 8601, e os horários livres usam o fuso do negócio.
  • Prefere explorar clicando? A referência interativa deixa montar e enviar cada chamada.

1. Ler o negócio

Leituras não mudam nada. Comece pelos serviços: o id de um deles entra nas próximas chamadas.

curl "https://agendria.com.br/api/v1/public/shops/sandbox-agendria/services"

2. Ver horários livres

Informe o serviço e quantos dias olhar (de 1 a 31). Cada horário traz start_at e os profissionais livres em staff_ids.

curl "https://agendria.com.br/api/v1/public/shops/sandbox-agendria/availability?service_id=SERVICE_ID&days=3"

3. Simular

bookings:quote confere horário, profissional e preço sem reservar nada e devolve um quote_id válido por 15 minutos. Mostre o resumo para a pessoa antes de seguir.

curl -X POST "https://agendria.com.br/api/v1/public/shops/sandbox-agendria/bookings:quote" \
  -H "Content-Type: application/json" \
  -d '{"service_id":"SERVICE_ID","start_at":"2026-10-12T13:00:00.000Z","guest_name":"Maria","guest_phone":"11988887777"}'

4. Agendar

Depois do sim, envie os mesmos campos com o quote_id. Usar o quote_id também como Idempotency-Key evita reserva duplicada se a chamada for repetida.

curl -X POST "https://agendria.com.br/api/v1/public/shops/sandbox-agendria/bookings" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: QUOTE_ID" \
  -d '{"service_id":"SERVICE_ID","start_at":"2026-10-12T13:00:00.000Z","guest_name":"Maria","guest_phone":"11988887777","quote_id":"QUOTE_ID"}'

5. Consultar e cancelar

Com o token no cabeçalho X-Booking-Token, você consulta a reserva (e o Pix, quando houver sinal), cancela ou remarca.

curl "https://agendria.com.br/api/v1/public/shops/sandbox-agendria/bookings/BOOKING_ID" \
  -H "X-Booking-Token: MANAGE_TOKEN"

curl -X POST "https://agendria.com.br/api/v1/public/shops/sandbox-agendria/bookings/BOOKING_ID:cancel" \
  -H "X-Booking-Token: MANAGE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"reason":"Imprevisto"}'

Próximos passos

  1. Entenda os limites

    Limites e erros mostra o que fazer com um 429 e com cada motivo de erro.

  2. Conecte um assistente

    O servidor MCP faz tudo isso por você no ChatGPT ou no Claude.

Primeiros passos · API e MCP · Agendria