Domaines : DKIM

Annuler la mise à niveau DKIM

Abandonne la clé 2048 bits en attente. Le domaine continue de signer avec sa clé actuelle, comme avant.

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

Nécessite le scope domain:create sur votre API key.

i

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

i

Ne fonctionne qu'avant la publication et la bascule de la nouvelle clé. Après la bascule, il n'y a plus rien à annuler.

Arguments

  • domainstringobligatoire

    Le nom du domaine.

    ex. : "acme-mail.com"

Démarrage rapide

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1/domain',
  {
    commands: [
      {
        command: "cancel_dkim_upgrade",
        args: {
          domain: "acme-mail.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": "cancel_dkim_upgrade",
      "id": "0",
      "type": "SUCCESS",
      "took_ms": 402,
      "data": {
        "domain": "acme-mail.com",
        "validated": true,
        "has_mx": true,
        "has_spf": true,
        "has_dkim": true,
        "has_dmarc": true,
        "has_return_path": true,
        "description": null,
        "dkim_key_size": 1024,
        "dkim_deprecated": true,
        "dkim_upgrade_pending": false,
        "created_at": "2026-09-02T14:21:07.118Z",
        "updated_at": "2026-10-21T02:40:51.902Z",
        "registrar": "cloudflare",
        "dns_records": {
          "spf": {
            "type": "TXT",
            "host": "acme.com",
            "value": "v=spf1 include:_spf.google.com include:smtp.emailsbit.com ~all"
          },
          "dkim": {
            "type": "TXT",
            "host": "sendcorex._domainkey",
            "value": "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu1SU1LfVLPHCozMxH2Mo4lgOEePzNm0tRgeLezV6ffAt0gunVTLw7onLRnrq0/IzW7yWR7QkrmBL7jTKEn5u+qKhbwKfBstIs+bMY2Zkp18gnTxKLxoS2tFczGkPLPgizskuemMghRniWaoLcyehkd3qqGElvW/VDL5AaWTg0nLVkjRo9z+40RQzuVaE8AkAFmxZzow3x+VJYKdjykkJ0iT9wCS0DRTXu269V264Vf/3jvredZiKRkgwlL9xNAwxXFg0x/XFw005UWVRIkdgcKWTjpBP2dPwVZ4WWC+9aGVd+Gyn1o0CLelf4rEjGoXbAAEgAqeGUxrcIlbjXfbcmwIDAQAB",
            "split_value": "\"v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu1SU1LfVLPHCozMxH2Mo4lgOEePzNm0tRgeLezV6ffAt0gunVTLw7onLRnrq0/IzW7yWR7QkrmBL7jTKEn5u+qKhbwKfBstIs+bMY2Zkp18gnTxKLxoS2tFczGkPLPgizskuemMghRniWaoLcyehkd3qqGElvW/VDL5AaWTg0nLVkjRo9z+40RQzuVaE8AkAF\" \"mxZzow3x+VJYKdjykkJ0iT9wCS0DRTXu269V264Vf/3jvredZiKRkgwlL9xNAwxXFg0x/XFw005UWVRIkdgcKWTjpBP2dPwVZ4WWC+9aGVd+Gyn1o0CLelf4rEjGoXbAAEgAqeGUxrcIlbjXfbcmwIDAQAB\""
          },
          "mx": {
            "type": "MX",
            "host": "acme.com",
            "value": "bounce.emailsbit.com",
            "priority": 0
          },
          "return_path": {
            "type": "CNAME",
            "host": "bounces",
            "value": "bounce.emailsbit.com"
          },
          "dmarc": {
            "type": "TXT",
            "host": "_dmarc",
            "value": "v=DMARC1; p=quarantine; rua=mailto:dmarc@bounces.acme.com"
          }
        },
        "spf_duplicate": false,
        "spf_duplicate_records": [],
        "dkim": {
          "version": 1,
          "key_size": 1024,
          "selector": "sendcorex",
          "deprecated": true,
          "upgrade_pending": false,
          "pending": null,
          "previous_selector": null,
          "keep_old_record_until": null,
          "just_upgraded": false
        }
      }
    }
  ]
}

Champs de la réponse

  • domain

    Le nom du domaine, en minuscules. C'est l'id que vous utilisez dans toutes les autres commandes.

  • validated

    true dès que le CNAME du Return-Path et l'enregistrement DKIM ont été trouvés. Seuls les domaines validés peuvent avoir des senders.

  • has_mx

    L'enregistrement MX pointe vers bounce.emailsbit.com. Facultatif : nécessaire uniquement pour recevoir les réponses et les bounces sur le domaine lui-même.

  • has_spf

    Votre SPF contient include:smtp.emailsbit.com.

  • has_dkim

    L'enregistrement TXT DKIM avec votre clé publique est publié.

  • has_dmarc

    Un enregistrement DMARC existe sur _dmarc.<domain>.

  • has_return_path

    Le CNAME du Return-Path (bounces.<domain> → bounce.emailsbit.com) est publié. Les bounces et l'alignement SPF en dépendent.

  • description

    Votre propre note sur le domaine, ou null.

  • dkim_key_size

    2048 ou 1024. null si le domaine n'a pas encore de clé.

  • dkim_deprecated

    true pour les clés 1024 bits. Certains fournisseurs les considèrent déjà comme faibles : passez à la version supérieure avec Start DKIM Upgrade.

  • dkim_upgrade_pending

    true tant qu'une nouvelle clé 2048 bits attend son enregistrement DNS.

  • created_at / updated_at

    ISO 8601, UTC.

  • registrar

    Où le DNS est hébergé, d'après ses serveurs de noms : cloudflare, namecheap, godaddy, route53, google, vercel, hostinger, ionos, hetzner, dreamhost, squarespace, registrobr ou other.

  • dns_records.spf / dkim / mx / return_path / dmarc

    Les enregistrements à publier. Chacun a type, host et value. Voir Enregistrements DNS ci-dessous.

  • dns_records.dkim_pending

    Uniquement pendant une mise à niveau DKIM : le nouvel enregistrement 2048 bits. Publiez-le à côté de l'actuel.

  • dns_records.*.split_value

    Uniquement pour les valeurs TXT de plus de 255 caractères : la même valeur déjà découpée en chaînes entre guillemets, pour les panneaux DNS qui l'exigent.

  • dns_records.mx.priority

    Toujours 0.

  • spf_duplicate

    true quand le domaine a plus d'un enregistrement SPF. C'est invalide : SPF échoue chez tous les destinataires tant que vous ne les fusionnez pas en un seul.

  • spf_duplicate_records

    Les enregistrements SPF trouvés, pour vous aider à les fusionner.

  • dkim

    La clé DKIM utilisée et toute mise à niveau en cours. Voir DKIM ci-dessous.

  • dkim.version

    2 pour les clés 2048 bits, 1 pour 1024.

  • dkim.key_size

    La taille de la clé qui signe actuellement vos emails.

  • dkim.selector

    Le sélecteur de la clé utilisée : le s= du header DKIM-Signature.

  • dkim.deprecated

    true pour les clés 1024 bits.

  • dkim.upgrade_pending

    true tant qu'une nouvelle clé attend son enregistrement DNS.

  • dkim.pending

    La nouvelle clé : selector, key_size, host, full_host, value, split_value, created_at. null s'il n'y a pas de mise à niveau.

  • dkim.previous_selector

    Pendant 48 heures après une mise à niveau : l'ancien sélecteur. Gardez son enregistrement jusqu'à keep_old_record_until, puis vous pouvez le supprimer.

  • dkim.keep_old_record_until

    Quand l'ancien enregistrement peut être supprimé. null s'il n'y a rien à supprimer.

  • dkim.just_upgraded

    true uniquement lors de l'appel qui a basculé vers la nouvelle clé.

Après l'annulation

  • L'enregistrement en attente

    Si vous avez déjà publié l'enregistrement sendcorex2, vous pouvez le supprimer.

  • Recommencer

    Start DKIM Upgrade crée une toute nouvelle clé : publiez la nouvelle valeur renvoyée, pas l'ancienne.

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.

  • CMDDKIM_NOT_FOUND

    Le domaine n'a pas de clé DKIM.

  • CMDNO_PENDING_UPGRADE

    Il n'y a aucune mise à niveau à annuler.

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