apipass-patterns

Padroes de Fluxo APIPASS

Montagem incremental

create_flow(name, projectId, confirm: true)   -> flowId
save_flow_development(id: flowId, steps: [...], lastGeneratedStepId, lastGeneratedLoopId, logEnabled, confirm: true)

Para alterar um fluxo existente: get_flow_development(flowId) -> ajuste os steps -> save_flow_development(...).

Contadores (regra critica)

• lastGeneratedStepId = id numerico do ultimo step gerado + 1 (NAO e apenas ">= o maior id"). Ex.: se o maior step gerado e a0, entao lastGeneratedStepId: 1.
• O step de fim e SENTINELA: a999 (.StopV2Step/.StopStep) usa um id fixo convencional e NAO conta para o calculo. Ignore-o ao achar o maior id gerado.
• Ao adicionar um step novo, use o valor atual de lastGeneratedStepId como id numerico do novo step e incremente o contador.
• lastGeneratedLoopId: idem para loops. >= 0.

Ler a estrutura

• get_flow_development(flowId) — os steps (use para aprender shapes e para editar).
• get_flow_info(flowId) — metadados do fluxo.
• export_flow_json(flowId) — exportacao completa em JSON.
• list_flow_versions(flowId) / get_version(versionId) — historico de versoes.

Publicacao (environment)

Publicar exige environmentId + historyId. Descubra-os primeiro:

• list_environments() — environments (ambientes) da conta.
• get_published_environments_for_flow(flowId) — onde o fluxo ja esta publicado. Depois:
• publish_flow(environmentId, historyId, confirm: true) — torna a versao ativa no environment (efeito real).
• unpublish_flow(environmentId, historyId, confirm: true) — despublica.

Pre-requisito do stop para publicar: o step de fim (.StopV2Step) precisa ter o array responses (ao menos a resposta Default 200). O save_flow_development/create_version aceitam o stop sem ele, mas publish_flow falha com HTTP 400 (reading 'map'). Shape minimo:

"responses": [
  { "description": "Default", "default": true, "responseData": { "status": "200" } },
  { "description": "Error", "responseData": { "status": "400", "contentType": "application/json" },
    "groups": [ { "rules": [ { "input": "{{$.flowExecution.status}}", "condition": "TEXT_DOES_NOT_MATCH", "expected": "OK" } ] } ] }
]