DataBolsa docs
Referência da APIExtensõesWalletFunctions

Catálogo de Functions

As leituras e cálculos que este módulo publica, como descritores curtos: id, título, critério de uso, sujeito, scopes e a rota de execução. O spec completo, com schemas, está em `GetFunction`.

GET
/v1/wallet/functions

Authorization

AuthorizationBearer <token>

In: header

Query Parameters

query?string

Texto livre: casa com id, título, descrição e critério.

domain?string

Recorta ao domínio.

subject_kind?string

Só capacidades que aceitam este tipo de sujeito.

subject_mode?string

object ou resource só as que exigem sujeito; none só as globais.

Value in"object" | "resource" | "none"
limit?integer

Candidatos a devolver.

Default50
Range1 <= value <= 100

Response Body

curl -X GET "https://api.databolsa.com/v1/wallet/functions?query=string&domain=string&subject_kind=string&subject_mode=object&limit=50"
{
  "data": [
    {
      "id": "string",
      "type": "primitive",
      "module": "string",
      "domain": "string",
      "title": "string",
      "description": "string",
      "criterio": "string",
      "subject": {
        "mode": "object",
        "kinds": [
          "company"
        ],
        "subkinds": [
          "string"
        ],
        "grain": "object"
      },
      "lifecycle": "default",
      "stability": "stable",
      "scopes": [
        "string"
      ],
      "confirmation": "required",
      "execute": {
        "method": "GET",
        "path": "string"
      },
      "describe": "string",
      "legacy_operation": "string"
    }
  ],
  "meta": {
    "next_cursor": null,
    "count": 0,
    "total": 0
  }
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "details": {
    "property1": null,
    "property2": null
  }
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "details": {
    "property1": null,
    "property2": null
  }
}

Spec de uma Function

O contrato executável: sujeito aceito, `input_schema`, `output_schema`, forma temporal e corte, paginação, autoridade e estabilidade.

Executa uma Action

Executa a escrita. Action com `confirmation: required` exige `confirmed: true`; `conditional` exige quando a prévia traz avisos — a recusa 409 `confirmation_required` traz a prévia em `details`. Com `idempotency_key`, a mesma chave e o mesmo input repetem a primeira resposta (`replayed: true`); a mesma chave com outro input responde 409 `idempotency_conflict`.