APRENDER. PRATICAR. EVOLUIR.Separar as perguntas operacionais
Uma equipa pode ter acesso à API, obter uma resposta sobre uma relação e continuar sem evidência do resultado de um pagamento. São perguntas diferentes. O exercício classifica respostas inventadas usando nomes documentados na referência RMA 1.0.0. HTTP 200 com NOT-AUTHORIZED significa que a consulta produziu um resultado negativo sobre a relação; não é prova de falha do transporte HTTP. Um erro de acesso também não demonstra revogação da relação. Ao construir o dashboard, conservar estas dimensões separadas. Os nomes locais RELATION_REPORTED_AUTHORIZED e API_OBSERVATION_FAILED são decisões didáticas da DR, não campos adicionais da API Swift.
Declarar quando falta observação
O modelo classifica 401, 403, 429 e 503 como observação falhada, exigindo investigação própria de cada erro. Não converte esses códigos em autorização nem recusa da relação. Uma resposta 200 sem estado utilizável recebe a classificação local INCOMPLETE_OBSERVATION. Para uma resposta negativa, este consumidor também exige uma razão reconhecida. Esta última exigência é uma regra de aceitação do exercício; não é apresentada como campo obrigatório no schema oficial. Em produção, alinhar o contrato do consumidor com a versão aplicável e definir o tratamento de respostas incompletas. Registar o desconhecido evita fabricar uma conclusão para simplificar o relatório.
Construir uma cache com âmbito explícito
A fixture guarda ambiente, emissor, correspondente, serviço, tipo de mensagem e instante observado. Trocar a ordem das partes muda o pedido; uma chave que apenas ordena alfabeticamente dois identificadores perde essa direção. Uma resposta para Pilot também não demonstra o estado em Live. O TTL de cinco unidades é inventado para testar a fronteira: observado em 100, o registo serve em 104 e deixa de servir em 105. Expirar a cache não significa que a relação expirou. Renovar só o timestamp fabricaria atualidade. Definir a política real exige equilibrar validade da evidência, capacidade, limites contratados e comportamento durante indisponibilidade.
Qualificar o ambiente e as credenciais
O guia RMA descreve um sandbox com respostas estáticas, útil para aprender pedidos e respostas. Isto não demonstra a relação real pretendida nem prontidão em Pilot ou Live. Não generalizar esta característica a todos os sandboxes Swift. O guia de autenticação distingue o scope Pilot swift.rma.api!p do scope Live swift.rma.api. Um token válido para um âmbito não elimina outras condições de acesso. A descrição 1.0.0 também contém uma particularidade sobre tráfego em Pilot sem registo RMA; não usar essa observação para inferir autorização em Live. No plano do PM, separar desenvolvimento local, qualificação do serviço e ativação operacional.
Produzir diagnóstico e comunicar em inglês
O X-Request-ID ajuda a localizar a consulta API; não substitui o UETR associado ao pagamento. Guardar ambiente, operação, hora, resultado HTTP e diagnóstico sanitizado permite encaminhar o incidente sem partilhar tokens. Na oficina abaixo, a equipa tem um erro de scope perto de um prazo interno. O resumo deve dizer que a consulta falhou e que o estado da relação não foi observado nesta execução. Atribuir responsáveis diferentes quando acesso, referência de dados e estado funcional exigirem equipas diferentes. Incluir impacto, próximo ponto de situação e evidência necessária. Evitar afirmar que todas as relações foram revogadas por causa de um erro de autorização HTTP.
Repetir o ensaio e registar os limites
Executar primeiro as fixtures sem alterações e comparar os resultados com o relatório. Depois mudar uma dimensão da chave, produzir um resultado incompleto e apresentar uma resposta negativa com HTTP 200. Prever cada classificação antes de executar. Os 35 controlos verificam o modelo local completo, incluindo deltas da aula anterior. Não existe chamada à API, autenticação real, consulta de diretório ou envio de mensagem. A oficina de 45 minutos permite praticar decisões e passagem de informação; só uma sessão efetivamente realizada permite registar participação. Uma aprovação externa, acesso contratado ou aceitação da operação necessita de evidência própria e não é atribuída pela conclusão deste curso.
DR original workshop / Oficina original DR: 45 minutes
Synthetic data only. No Swift API call, credentials or real messages.
Apenas dados sintéticos. Sem chamada API Swift, credenciais ou mensagens reais.
0-10 min: Classify / Classificar
HTTP 200, authorization_status=NOT-AUTHORIZED, reason=REVOKED
The query returned a negative relationship observation.
A consulta devolveu uma observação negativa sobre a relação.
HTTP 403: API observation failed; relationship state remains unobserved.
HTTP 403: observação falhada; estado da relação não observado.
10-20 min: Scope and freshness / Âmbito e atualidade
Cache: PILOT, A -> B, DR-SERVICE, DR-TYPE-1, observed_at=100.
Request: LIVE, B -> A, DR-SERVICE, DR-TYPE-2, now=104.
Reject reuse: environment, direction and message differ.
Recusar reutilização: ambiente, direção e mensagem são diferentes.
For matching scope with fictional TTL=5: now=105 is expired.
Com âmbito igual e TTL fictício de 5: now=105 já expirou.
20-35 min: English decision note / Resumo de decisão em inglês
Observed: access scope error; no current relationship result from this run.
Impact: the dependent readiness decision remains pending.
Action: assign API access investigation and authorized relationship lookup.
Evidence: environment, operation, time, request ID, sanitized diagnostics.
Next update: choose a specific time and accountable owner.
Do not attach tokens or claim payment settlement.
Não anexar tokens nem afirmar liquidação de pagamentos.
35-45 min: Handover / Passagem à operação
Another participant reproduces the model and explains missing evidence.
Outro participante reproduz o modelo e explica a evidência em falta.
Solo practice records self-review, not independent operational acceptance.
Prática individual regista autoavaliação, não aceitação operacional independente.
Deliver code hash, synthetic inputs, expected/actual results and open questions.
Entregar hash do código, dados sintéticos, resultados esperados/observados e questões abertas.
Caso: uma cache reutiliza A→B em Pilot para B→A em Live. O token Live válido não corrige a associação; obter uma observação do âmbito correto.
Armadilhas comuns
HTTP 200 como autorização universal; erro 403 como revogação; cache expirada como relação expirada; resposta estática como qualificação Live.
Tópicos relacionados: Identificadores, relações e dados de referência · Estados, reconciliação e recuperação sem duplicar · Continuidade e passagem à operação
Interpretar a resposta no ambiente, direção, serviço, tipo e momento corretos; comunicar observações e desconhecidos sem inferir liquidação.
Referência: Relationship Management API reference 1.0.0 · DR Swift knowledge assessment2026.10; independent professional curriculum