Domaines : domaines
Supprimer un domaine
Supprime un domaine, sa clé DKIM et tous ses senders. Vous ne pouvez plus envoyer depuis ce domaine.
https://g.sendcorex.com/v1/domaincommand: delete_domainNécessite le scope domain: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. Ajouter à nouveau le domaine crée une nouvelle clé DKIM : l'enregistrement DNS devra être republié.
Arguments
domainstringobligatoireLe nom du domaine.
ex. :
"acme.com"
Démarrage rapide
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/domain',
{
commands: [
{
command: "delete_domain",
args: {
domain: "acme.com"
}
}
]
},
{ 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_domain",
"id": "0",
"type": "SUCCESS",
"took_ms": 24,
"data": {
"domain": "acme.com",
"deleted": true,
"senders_deleted": 3
}
}
]
}Champs de la réponse
domainLe domaine supprimé.
deletedToujours
true.senders_deletedCombien de senders ont été supprimés avec lui.
Après la suppression
Enregistrements DNSVous pouvez supprimer les enregistrements Sendcorex (DKIM, Return-Path, l'include SPF) de votre DNS.
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 : `domain` manquant ou mal formé, `key_size` autre que 1024/2048, `email` invalide, une description de plus de 255 caractères…
- CMD
DOMAIN_NOT_FOUNDLe domaine 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.