wagend
PT

Para devs

Para devs: API, SDKs, MCP e webhooks

O painel usa a mesma API que você. Reserve de qualquer sistema, receba eventos assinados e deixe agentes de IA operarem o negócio.

  • API REST

    Escopos por chave, Idempotency-Key, paginação por cursor e erros RFC 9457.

    Ler a documentação

  • SDKs

    TypeScript e Python gerados do OpenAPI. Hoje se usam a partir do repositório.

    Ler a documentação

  • MCP

    Ferramentas de reserva e de administração para agentes de IA. Servidor hospedado: em breve.

    Ler a documentação

  • Webhooks

    Eventos assinados com HMAC, reenvios e log de entregas.

    Ler a documentação

Quickstart em quatro passos

  1. 1

    Crie uma chave

    No painel, em Configurações, Desenvolvedores: crie uma chave de produção com os escopos slots:read e bookings:write. Ela é mostrada uma única vez.

  2. 2

    Busque horários

    GET /slots devolve só horários reais que cruzam todos os recursos do serviço.

  3. 3

    Reserve em dois passos

    POST /holds retém por 10 minutos e POST /holds/id/confirm confirma. Use Idempotency-Key em todo POST.

  4. 4

    Escute os eventos

    Cadastre um endpoint em /webhook-endpoints e verifique a assinatura de cada entrega.

Exemplos

export WAGEND_KEY="wg_live_xxxxxxxx_xxxxxxxxxxxxxxxxxxxx"

# 1. Real slots for the service
curl -s "https://api.wagend.app/v1/slots?service_id=svc_corte&from=2026-10-15T09:00:00-03:00&to=2026-10-15T18:00:00-03:00" \
  -H "Authorization: Bearer $WAGEND_KEY"

# 2. 10-minute hold
curl -X POST https://api.wagend.app/v1/holds \
  -H "Authorization: Bearer $WAGEND_KEY" \
  -H "Idempotency-Key: 8c1f2a9e-4b7d-4e0a-9d51-3a6f0c2b7e11" \
  -H "Content-Type: application/json" \
  -d '{
    "service_id": "svc_corte",
    "start": "2026-10-15T09:45:00-03:00",
    "customer": { "name": "Carlos", "phone": "+5521999990000" }
  }'

# 3. Confirm (use the id returned by step 2)
curl -X POST https://api.wagend.app/v1/holds/HOLD_ID/confirm \
  -H "Authorization: Bearer $WAGEND_KEY" \
  -H "Idempotency-Key: 5d0e7a31-91c4-4f6b-8a2e-7c1b9e4d2f60" \
  -H "Content-Type: application/json" \
  -d '{}'

As chaves dos exemplos são fictícias. Os SDKs ainda não estão publicados em npm nem PyPI: veja a documentação para usá-los a partir do repositório.

Servidor MCP

O servidor MCP usa a mesma chave de API e nunca dá mais permissões do que ela. Hoje você o executa a partir do repositório; a versão hospedada em mcp.wagend.app está em breve.

Continue na documentação

Prefere dar a documentação a uma IA? Use llms.txt e llms-full.txt. llms.txt · llms-full.txt