Remodeler une réponse

Guide d'exploitation : configurer, déployer et observer la passerelle. Ce que fait la capacité côté produit : guide produit ; l'appeler : guide développeur.

Objectif : ne servir que ce que le contrat publie, masquer des données personnelles, traduire les statuts non standard d'un amont - sans toucher à l'amont.

Commande - trois politiques dans flexway.yaml, attachées à l'opération ou à des routes :

policies:
  definitions:
    public-order:
      type: transform-body
      config: { project: [id, status, total, items, customer], on_missing: fail }   # liste fermée ; fail | omit
    no-pii:
      type: redact
      config: { fields: [body.customer.email, body.customer.phone], with: "***" }   # ou remove: true
    legacy-errors:
      type: map-status
      config:
        - { from: 200, when: "has(body.error)", to: 422, code: legacy_rejected }    # condition CEL sur le corps
        - { from: 520, to: 502 }

Vérif : GET /orders/7 ne rend que les champs listés, customer.email vaut "***" ; un 200 qui porte error arrive en 422 application/problem+json (code: legacy_rejected), sans les mots de l'amont ; flexway_policy_executions_total{phase="response"} compte chaque politique appliquée, par opération, et flexway_policy_skipped_total celles que leur condition a ignorées (1.2.0).

Règle	Ce qu'elle veut dire
Ordre	map-status décide du statut, puis transform-body, puis redact - quel que soit l'ordre de la chaîne
Coût	Le corps de ces opérations est lu en entier (JSON seulement) ; toutes les autres restent en relais direct
Succès projetés	transform-body ne touche que les 2xx ; redact masque toute réponse, erreurs comprises
Erreur produite	map-status vers un 4xx/5xx : problème RFC 9457, corps de l'amont abandonné ; vers un succès : il doit être déclaré par l'opération
Jamais brut	Au-delà de server.body.max_bytes (1 Mio) : 502 response_too_large ; un corps illisible ou non JSON : 502 upstream_error - jamais servi tel quel
Coupe-circuit	Il compte le code amont : un 503 servi en 422 reste une panne
Refusé au chargement	Un flux, une réponse non JSON, gRPC, l'inférence ; une projection qui retire un champ requis ou garde un champ non déclaré ; un masque du mauvais type ; un exemple du contrat qui, transformé, ne tient plus son schéma - le message nomme l'opération
Conformité	server.body.validate_sample (0.01) des corps servis validés contre le contrat : un écart compte flexway_policy_nonconformant_total, jamais un refus ; rechargeable
Cache	Le cache garde la réponse de l'amont ; un succès de cache est transformé comme un échec

Exemple complet : Corps et statut de réponse.