Senders : senders
Supprimer un expéditeur
Supprime un sender. Vous ne pouvez plus envoyer depuis son adresse.
https://g.sendcorex.com/v1/sendercommand: delete_senderNécessite le scope sender:delete sur votre API key.
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_idstringobligatoireLe 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_idLe sender supprimé.
deletedToujours
true.
Après la suppression
Logs et historiqueLes 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.
- 401
INVALID_API_KEYL'API key n'existe pas, a été révoquée ou désactivée dans le dashboard.
- 429
RATE_LIMITEDPlus 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.
- CMD
MISSING_SCOPEL'API key n'a pas le scope requis par cette commande.
- CMD
INVALID_ARGSUn 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…
- CMD
SENDER_NOT_FOUNDLe sender n'est pas sur votre compte.
- CMD
RATE_LIMITEDCette commande a été appelée trop de fois par votre compte au cours de la dernière minute. Attendez une minute.
- CMD
INTERNALErreur serveur. Le détail n'est écrit que dans le log du serveur.