Agendamentos
sob seu controle.

# Teste de conectividade — busca slots disponíveis
curl https://api.agendaki.app/v1/availability \
  -H "Authorization: Bearer ak_live_YOUR_KEY_HERE" \
  -G \
  --data-urlencode "professional_id=PROF_ID" \
  --data-urlencode "service_id=SERVICE_ID" \
  --data-urlencode "date=2026-05-10"

# Cria um agendamento
curl -X POST https://api.agendaki.app/v1/appointments \
  -H "Authorization: Bearer ak_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "professional_id": "PROF_ID",
    "service_id": "SERVICE_ID",
    "customer": {
      "name": "João Silva",
      "phone": "+55 11 91234-5678"
    },
    "starts_at": "2026-05-10T09:00:00-03:00"
  }'

GET /v1/availability HTTP/1.1
Host: api.agendaki.app
Authorization: Bearer ak_live_4xKj9mRzQp8nVs2wYe3bDcFgHjKm
Content-Type: application/json

// Verificação de assinatura (Node.js / Edge)
import { createHmac } from "crypto";

export function verifyWebhook(
  rawBody: string,
  signature: string,  // header X-Agendaki-Signature
  secret:    string,
): boolean {
  const expected = createHmac("sha256", secret)
    .update(rawBody)
    .digest("hex");
  // timing-safe comparison
  return expected === signature;
}

// Handler de exemplo (Next.js Route Handler)
export async function POST(req: Request) {
  const rawBody  = await req.text();
  const sig      = req.headers.get("X-Agendaki-Signature") ?? "";
  const verified = verifyWebhook(rawBody, sig, process.env.WEBHOOK_SECRET!);

  if (!verified) return new Response("Unauthorized", { status: 401 });

  const event = JSON.parse(rawBody);
  switch (event.type) {
    case "appointment.created":
      await handleNewAppointment(event.data);
      break;
    case "appointment.cancelled":
      await handleCancellation(event.data);
      break;
  }

  return new Response("ok");
}

// Exemplo de resposta de erro
{
  "ok":      false,
  "code":    "SLOT_UNAVAILABLE",
  "message": "O horário solicitado não está mais disponível.",
  "details": {
    "starts_at": "2026-05-10T14:00:00-03:00"
  }
}

HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit:     300
X-RateLimit-Remaining: 0
X-RateLimit-Reset:     1746892800
Retry-After:           12

{
  "ok":      false,
  "code":    "RATE_LIMITED",
  "message": "Limite de requisições atingido. Tente novamente em 12 segundos."
}

// GET /v1/appointments?limit=50&cursor=eyJpZCI6...
{
  "ok":   true,
  "data": [ /* ... 50 agendamentos ... */ ],
  "meta": {
    "total":       1240,
    "has_more":    true,
    "next_cursor": "eyJpZCI6Ijg5MDEyMzQ1LTY3ODktYWJjZCJ9",
    "prev_cursor": null
  }
}