Domaines : domaines

Supprimer un domaine

Supprime un domaine, sa clé DKIM et tous ses senders. Vous ne pouvez plus envoyer depuis ce domaine.

POSThttps://g.sendcorex.com/v1/domaincommand: delete_domain
i

Nécessite le scope domain: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. Ajouter à nouveau le domaine crée une nouvelle clé DKIM : l'enregistrement DNS devra être republié.

Arguments

  • domainstringobligatoire

    Le 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

  • domain

    Le domaine supprimé.

  • deleted

    Toujours true.

  • senders_deleted

    Combien de senders ont été supprimés avec lui.

Après la suppression

  • Enregistrements DNS

    Vous pouvez supprimer les enregistrements Sendcorex (DKIM, Return-Path, l'include SPF) de votre DNS.

  • 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 : `domain` manquant ou mal formé, `key_size` autre que 1024/2048, `email` invalide, une description de plus de 255 caractères…

  • CMDDOMAIN_NOT_FOUND

    Le domaine 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.