POST /messenger/create-message

version 2.0.0

Créer un nouveau message.

Authentification

Cette route nécessite de mettre votre clé API dans le Header.

👥 Autorisation

Les personnes autorisées pour utiliser cette requête sont :

• Corail
• Zelta

🧾 Paramètres

Les champs suivants sont attendus dans le corps de la requête :

Nom	Type	Dans	Requis	Description	Valeur par default
body	string	Body	✅	Le message	❌
headers	string	Body	✅	L'entête du message	❌
queueName	string	Body	✅	Le nom du message?	❌
createdAt	string	Body	❌	Le moment où le message a été crée	currentTimeStamp
availableAt	string	Body	❌	Le moment où le message sera accessible	currentTimeStamp
deliveredAt	string	Body	❌	Le moment où le message est reçu	❌

🧾 Réponse

Les données que l'API retournera avec le succès de la requête :

Nom	Type	Nullable	Description
id	number	❌	L’identifiant du message
body	string	❌	Le message
headers	string	❌	L'entête du message
queueName	string	❌	Le nom du message?
createdAt	string	❌	Le moment où le message a été crée
availableAt	string	❌	Le moment où le message sera accessible
deliveredAt	string	✅	Le moment où le message est reçu

📤 Exemple de requête

http://0.0.0.0/api/messenger/create-message

Et dans le body mettre par exemple :

{
    "id": 7,
    "body": "Je ne suis pas sûr pour le 'queue_name'",
    "headers": "Advienne que pourra",
    "queueName": "Le nom du message?",
    "availableAt": "2025-11-12T11:00:00Z"
}

📥 Exemple de réponse

Si le message est bien créé (code 201) :

{
    "id": 7,
    "body": "Je ne suis pas sûr pour le 'queue_name'",
    "headers": "Advienne que pourra",
    "queueName": "Le nom du message?",
    "createdAt": "2025-10-12T10:00:00Z",
    "availableAt": "2025-11-12T11:00:00Z",
    "deliveredAt": null
}

⛔ Les erreurs

Les différents types d'erreurs :

Code HTTP	Description	Cause possible
400	Bad Request	Paramètres manquants ou invalides
401	Unauthorized	Clé API manquante ou invalide
403	Forbidden	Droits insuffisants pour utiliser la requête
500	Internal Server Error	Erreur interne du serveur

Attention !

En cas d'erreur 500, contactez directement Zeltaria avec votre requête, sa réponse ainsi que toutes informations que vous jugez pertinentes !

En cas d'erreur voici les informations que retourne l'API

Nom	Type	Description
code	number	Le code d'erreur que retourne la requête
message	string	Le message de l'API expliquant l'erreur

Exemple avec l'erreur 403 Forbidden :

Ici par exemple, l'erreur 403 signifie que vous n'avez pas accès à cette requête.

{
    "message": "Access Denied",
    "code": 403
}