Responde "quais despachos estão vinculados a este processo (assunto)", com o nome de cada um — o que permite configurar um assunto sem conhecer nenhum UUID de despacho de antemão.
O :id aceita o UUID do blueprint process ou o _id do assunto no Mongo (24 hex, resolvido via legacyId).
Só tem o nome do assunto? Resolva primeiro em GET /hub-api/type/find?cidade=&uf=&titulo=, que devolve o _id do assunto, e passe esse _id aqui. Esta rota não busca por nome de propósito: a busca por título é semântica do Mongo e duplicá-la aqui criaria uma segunda fonte de verdade.
O vínculo lido é blueprint_process.available_custom_posts (Postgres do core-api) — a resposta declara isso em linkedBy, porque não é o form do assunto no Mongo que guarda essa fiação.
⚠️ Caveats:
- UUID vinculado que não existe, ou que é de outra city, volta em
unresolvedcom o motivo e a resposta segue200— comum em assunto duplicado entre cidades, que copia a fiação apontando pra ids da city de origem. Uma listaunresolvednão vazia é sinal de parametrização quebrada, não de erro da chamada.- Por padrão despacho desabilitado ou deletado aparece na lista com as flags
disabled/deleted; useonlyEnabled=truepra esconder. Nada é filtrado sem flag.- É um retrato do momento, sem lock — o Estúdio pode mudar o vínculo no segundo seguinte.
- Isto descreve o assunto, não processos já protocolados:
form_tramitesé snapshotado dentro de cada processo na protocolização.
A direção reversa (dado um despacho, em quais assuntos ele está vinculado) não existe: o vínculo é guardado só no lado do processo, sem back-reference.
Query param desconhecido responde 400 (não é descartado em silêncio).
curl -i -X GET \
'https://api.producao.aprova.com.br/hub-api/blueprint-process/69aae29b8f070e4432a63036/blueprint-posts?hydrate=true&onlyEnabled=false' \
-H 'x-api-key: YOUR_API_KEY_HERE'Despachos vinculados ao processo
Qual fiação respondeu — sempre blueprint_process.available_custom_posts
{ "process": { "id": "8f2b1c44-9d3e-4a55-b0c1-2e7f9a6d5b41", "legacyId": "69aae29b8f070e4432a63036", "title": "Alvará de Construção", "subject": "Alvará de Construção", "cityId": 138, "disabled": false }, "linkedBy": "blueprint_process.available_custom_posts", "total": 1, "blueprintPosts": [ { … } ], "unresolved": [ { … } ] }