Envoyer un message | Goodflag Docs

curl -X POST https://lp7signbox.example.com/LP7SignBox/pki/sendMessage \
     -H "Content-Type: application/json" \
     -d '{
  "message": "Votre code de signature est 482913. Il est valable 10 minutes.",
  "keyReferenceId": "8F2A61C0D94B7E3A55F1C2D8B6A0E9F4C3D2B1A0",
  "requestID": "msg-2026-09-11-0001",
  "subscriber": {
    "emailAddress": "marie.dupont@example.com",
    "phoneNumber": "+33612345678"
  }
}'

{
  "requestID": "msg-2026-09-11-0001",
  "senderResponses": {
    "senderResponse": [
      {
        "date": 1757592000000,
        "responseCode": "200",
        "url": "https://sms-gateway.example.com/api/messages/sms-7f3a9c2e",
        "messageID": "sms-7f3a9c2e",
        "freeText": "Message accepted",
        "ID": "1"
      }
    ]
  },
  "result": {
    "minorCode": 0,
    "majorCode": 0,
    "message": "OK"
  }
}

Envoie un message à un porteur par e-mail ou SMS, par exemple pour lui transmettre un mot de passe à usage unique.

Authentification : TLS mutuel (certificat client).

Requête

This endpoint expects an object.

messagestringRequis

Le texte du message.

keyReferenceIdstringOptionnel

La référence de la clé à laquelle le message se rapporte.

requestIDstringOptionnel

L’identifiant de la requête, choisi par l’appelant. Renvoyé tel quel dans la réponse.

subscriberobjectOptionnel

Le destinataire du message.

Réponse

L’opération a été traitée. Le résultat est donné par le champ result, renseigné aussi lorsque l’opération a échoué pour une raison métier.

requestIDstringOptionnel

L’identifiant de la requête, choisi par l’appelant. Renvoyé tel quel dans la réponse.

senderResponsesobjectOptionnel

Les réponses des passerelles de messagerie.

resultobjectOptionnel

Les codes et le message de retour du serveur.

Erreurs

400

Bad Request Error