Spec de uma Action
O contrato executável: `input_schema`, `output_schema`, confirmação, idempotência, efeitos e evento de auditoria.
In: header
Path Parameters
Id qualificado da Action, como o catálogo em GET {base}/actions a publica.
Response Body
curl -X GET "https://api.databolsa.com/v1/advisor/actions/string"{
"id": "string",
"type": "action",
"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",
"version": 1,
"preview": true,
"idempotency": "key",
"effects": [
"string"
],
"audit_event": "string",
"input_schema": {
"property1": null,
"property2": null
},
"output_schema": {
"property1": null,
"property2": null
},
"preview_path": "string"
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"details": {
"property1": null,
"property2": null
}
}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`.
Catálogo de Actions
As escritas que este módulo publica, como descritores curtos: id, efeito, recurso, scopes, confirmação exigida e a rota de execução. `query` casa com id, título e descrição.