Recevoir des e-mails : Organiser
Supprimer
Supprimez définitivement des messages. Seuls les messages dans la Corbeille ou dans Spam peuvent être supprimés.
https://g.sendcorex.com/v1command: deleteCette action est irréversible. Pour envoyer un message à la corbeille, utilisez plutôt move avec to_folder: "Trash".
Un message qui se trouve aussi dans un autre dossier (par exemple une réponse dans Sent) est seulement retiré de la Corbeille. Il n'est pas effacé.
Arguments
idsstring[]facultatifJusqu'à 100 ids de message.
idstringfacultatifUn seul id de message. Utilisez-le ou
ids.from_folderstringobligatoireDoit être
TrashouSpam. Toute autre valeur échoue avecNOT_IN_TRASH.scopestringfacultatifthread(par défaut) oumessage.
Démarrage rapide
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "delete",
args: {
id: "Vj0xQUJDMTIz",
from_folder: "Trash"
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_TOKEN } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Réponse
{
"type": "SUCCESS",
"results": [
{
"command": "delete",
"id": "0",
"type": "SUCCESS",
"data": {
"items": [
{
"id": "Vj0xQUJDMTIz",
"ok": true,
"data": {
"changed": 1,
"deleted": 1,
"removed": 0
}
}
],
"ok_count": 1,
"failed_count": 0
}
}
]
}Champs de la réponse
items[].data.changedEntrées modifiées.
items[].data.deletedMessages effacés définitivement.
items[].data.removedMessages seulement retirés du dossier car ils se trouvent aussi dans un autre dossier.
Erreurs
Les erreurs au niveau HTTP renvoient type, code et message. Les erreurs marquées CMD reviennent dans le résultat de la commande, avec HTTP 200.
- 401
TOKEN_EXPIREDL'access token a expiré. Appelez Refresh Token et relancez la requête.
- 401
INVALID_TOKENLe token est mal formé, inconnu ou révoqué.
- 429
RATE_LIMITEDPlus de 15 requêtes/s ou 15 en cours pour la même IP + boîte aux lettres. Attendez le nombre de secondes indiqué dans Retry-After.
- CMD
INVALID_ARGSUn argument obligatoire est manquant ou invalide.
- CMD
NOT_FOUNDLe message, la conversation ou le dossier n'existe pas pour ce token.
- CMD
NOT_IN_TRASHdelete ne fonctionne que sur les messages dans la Corbeille ou dans Spam. Utilisez d'abord move pour envoyer un message à la Corbeille.
- CMD
INTERNALErreur serveur. Le détail est uniquement écrit dans le log du serveur.