Senders : senders

Supprimer un expéditeur

Supprime un sender. Vous ne pouvez plus envoyer depuis son adresse.

POSThttps://g.sendcorex.com/v1/sendercommand: delete_sender
i

Nécessite le scope sender:delete sur votre API key.

i

Jusqu'à 30 appels par minute et par compte. Au-delà, la commande répond RATE_LIMITED.

!

Cette action est irréversible. Recréer la même adresse repart d'une réputation nulle.

Arguments

  • sender_idstringobligatoire

    Le sender à supprimer.

    ex. : "K7Q2M9XR4TB8WD1ZC6NF3HJP"

Démarrage rapide

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1/sender',
  {
    commands: [
      {
        command: "delete_sender",
        args: {
          sender_id: "K7Q2M9XR4TB8WD1ZC6NF3HJP"
        }
      }
    ]
  },
  { headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);

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_sender",
      "id": "0",
      "type": "SUCCESS",
      "took_ms": 7,
      "data": {
        "sender_id": "K7Q2M9XR4TB8WD1ZC6NF3HJP",
        "deleted": true
      }
    }
  ]
}

Champs de la réponse

  • sender_id

    Le sender supprimé.

  • deleted

    Toujours true.

Après la suppression

  • Logs et historique

    Les logs, bounces et compteurs des emails déjà envoyés sont conservés.

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.

  • 401INVALID_API_KEY

    L'API key n'existe pas, a été révoquée ou désactivée dans le dashboard.

  • 429RATE_LIMITED

    Plus de 15 requêtes/s ou 15 simultanées pour la même IP + API key. Attendez le nombre de secondes indiqué dans Retry-After.

  • CMDMISSING_SCOPE

    L'API key n'a pas le scope requis par cette commande.

  • CMDINVALID_ARGS

    Un argument est invalide : `sender_id` manquant, un username contenant d'autres caractères que lettres, chiffres, `.`, `_` et `-`, un `reply_to` invalide, un nom de plus de 100 caractères ou contenant du HTML…

  • CMDSENDER_NOT_FOUND

    Le sender n'est pas sur votre compte.

  • CMDRATE_LIMITED

    Cette commande a été appelée trop de fois par votre compte au cours de la dernière minute. Attendez une minute.

  • CMDINTERNAL

    Erreur serveur. Le détail n'est écrit que dans le log du serveur.