Referência da API/Agentes e MCP

Agentes e MCP

Permita que um agente de software pague pessoas e fornecedores sob uma política definida por uma pessoa. Uma chave com orçamento diário, máximo por pagamento, canais permitidos e limite de aprovação executa pagamentos abaixo do limite e deixa o restante na caixa de aprovações. Um número de telefone é um beneficiário válido, então um agente nunca precisa coletar dados bancários.

A camada de políticas fica sobre a API; fale conosco antes de construir sobre ela.

Create a scoped key

POST/api-keys

Owner only. A key carries an optional policy; anything outside it returns policy_exceeded or waits for approval above the threshold.

Campo	Tipo	obrigatório	Observações
name	string	obrigatório
policy	object	opcional

Requisição

{
  "name": "support-agent",
  "policy": {
    "daily_budget": "2000.00",
    "per_payout_max": "200.00",
    "channels": [
      "claim_link",
      "spei_mxn"
    ],
    "approval_threshold": "150.00"
  }
}

Resposta 201

{
  "id": "key_7e21",
  "name": "support-agent",
  "key": "dpc_test_9Qa...",
  "policy": {
    "daily_budget": "2000.00",
    "per_payout_max": "200.00",
    "channels": [
      "claim_link",
      "spei_mxn"
    ],
    "approval_threshold": "150.00"
  }
}

Exemplos: Create a scoped key

curl -X POST https://sandbox.api.decaf.so/v1/api-keys \
  -H "Authorization: Bearer $DECAF_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"support-agent","policy":{"daily_budget":"2000.00","per_payout_max":"200.00","channels":["claim_link","spei_mxn"],"approval_threshold":"150.00"}}'

Obtenha acesso

Construa contra o sandbox esta semana.

Conte-nos os corredores de que precisa e quem você paga. As chaves de sandbox são emitidas por uma pessoa.