Aller au contenu

Consultation

Lister les échanges d'un courrier

GET /rest/resources/{resId}/messageExchanges

Droits

Le courrier doit être dans le périmètre de l'utilisateur.

Réponse 200

{
  "messageExchanges": [
    {
      "messageId": "MC_20260702_000001",
      "creationDate": "2026-07-02 10:30:00",
      "type": "m2m_ARCHIVETRANSFER",
      "sender": "Jean Dupont (Pole juridique)",
      "recipient": "Instance B (FR-MC-B)",
      "receptionDate": "2026-07-02T08:31:00+00:00",
      "operationDate": null,
      "status": "sent"
    }
  ]
}

Lire le détail d'un échange

GET /rest/messageExchanges/{id}

Paramètres

Nom Emplacement Type Obligatoire Description
id path string Oui Identifiant du message exchange.

Réponse 200

{
  "messageExchange": {
    "userId": 19,
    "messageId": "MC_20260702_000001",
    "creationDate": "2026-07-02 10:30:00",
    "type": "m2m_ARCHIVETRANSFER",
    "sender": "Jean Dupont (Pole juridique)",
    "recipient": {
      "label": "Instance B",
      "m2m": "FR-MC-B"
    },
    "receptionDate": "2026-07-02T08:31:00+00:00",
    "operationDate": null,
    "status": "SENT",
    "operationComments": null,
    "from": "Jean Dupont (Pole juridique)",
    "communicationType": "https://instance-b.example.org/rest/saveNumericPackage",
    "contactInfo": "Instance B - <b>FR-MC-B</b> - Contact M2M",
    "body": "Bonjour, veuillez trouver le pli numérique.",
    "object": "Transmission du dossier",
    "notes": [301],
    "attachments": [201],
    "resMasterAttached": true,
    "disposition": [],
    "reference": "MC_20260702_000001",
    "messageReview": []
  }
}

Télécharger le contenu archivé

GET /rest/messageExchanges/{id}/archiveContent

Réponse 200

Retourne le fichier archivé, avec un header :

Content-Disposition: attachment; filename=maarch.zip

Erreurs fréquentes

  • 400 Bad Request : message introuvable, docserver introuvable ou fichier absent du docserver.
  • 403 Forbidden : courrier hors périmètre.

Supprimer un échange en erreur

DELETE /rest/messageExchanges/{id}

Contraintes

Seuls les messages en statut E peuvent être supprimés.

Réponses

  • 204 No Content : message supprimé.
  • 400 Bad Request : message introuvable ou statut non supprimable.
  • 403 Forbidden : courrier hors périmètre.