Recevoir des e-mails : Organiser

Supprimer

Supprimez définitivement des messages. Seuls les messages dans la Corbeille ou dans Spam peuvent être supprimés.

POSThttps://g.sendcorex.com/v1command: delete
!

Cette action est irréversible. Pour envoyer un message à la corbeille, utilisez plutôt move avec to_folder: "Trash".

i

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[]facultatif

    Jusqu'à 100 ids de message.

  • idstringfacultatif

    Un seul id de message. Utilisez-le ou ids.

  • from_folderstringobligatoire

    Doit être Trash ou Spam. Toute autre valeur échoue avec NOT_IN_TRASH.

  • scopestringfacultatif

    thread (par défaut) ou message.

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.changed

    Entrées modifiées.

  • items[].data.deleted

    Messages effacés définitivement.

  • items[].data.removed

    Messages 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.

  • 401TOKEN_EXPIRED

    L'access token a expiré. Appelez Refresh Token et relancez la requête.

  • 401INVALID_TOKEN

    Le token est mal formé, inconnu ou révoqué.

  • 429RATE_LIMITED

    Plus 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.

  • CMDINVALID_ARGS

    Un argument obligatoire est manquant ou invalide.

  • CMDNOT_FOUND

    Le message, la conversation ou le dossier n'existe pas pour ce token.

  • CMDNOT_IN_TRASH

    delete ne fonctionne que sur les messages dans la Corbeille ou dans Spam. Utilisez d'abord move pour envoyer un message à la Corbeille.

  • CMDINTERNAL

    Erreur serveur. Le détail est uniquement écrit dans le log du serveur.