Domaines : DKIM

Lancer la mise à niveau DKIM

Fait passer un domaine d'une clé DKIM 1024 bits à une clé 2048 bits sans interrompre vos envois. Crée la nouvelle clé sur un nouveau sélecteur et renvoie l'enregistrement à publier.

POSThttps://g.sendcorex.com/v1/domaincommand: start_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

Peut être appelé deux fois sans risque : si une mise à niveau est déjà en cours, vous récupérez la même clé en attente.

!

Ne modifiez pas et ne supprimez pas l'enregistrement DKIM actuel. Ajoutez le nouveau à côté.

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: "start_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": "start_dkim_upgrade",
      "id": "0",
      "type": "SUCCESS",
      "took_ms": 620,
      "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": true,
        "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-mail.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=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDCfGv4Yz2sTJHJ7BwjYjLlcHpL1OVJ0eA6Gg3Z3sQhZ2y1nI4S0Zl8q7vUJr5cQ1a2b3c4d5e6f7g8h9i0j1k2l3m4n5o6p7q8r9s0t1u2v3w4x5y6z7A8B9C0D1E2F3G4H5I6J7K8L9M0N1O2P3Q4R5S6T7U8V9W0X1Y2Z3wIDAQAB"
          },
          "dkim_pending": {
            "type": "TXT",
            "host": "sendcorex2._domainkey",
            "value": "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAw3v8Qk2Lr9sT1yH6pE0bN4cM7xZ2aJ5fG8dK1uV3oW9qR6tY0iS4eL2nB7mC5vX8zA1sD3fH6jK9lP0oI2uY4tR7eW1qA5sZ8xC3vB6nM9kL2jH5gF8dS1aP4oI7uY0tR3eW6qA9sZ2xC5vB8nM1kL4jH7gF0dS3aP6oI9uY2tR5eW8qA1sZ4xC7vB0nM3kL6jH9gF2dS5aP8oI1uY4tR7eW0qA3sZ6xC9vB2nM5kL8jH1gF4dS7aP0oI3uY6tR9eW2qA5sZ8xC1vB4nM7kL0jH3gF6dS9aP2oI5uY8tR1eW4qA7sZ0xC3vB6nM9QIDAQAB",
            "split_value": "\"v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAw3v8Qk2Lr9sT1yH6pE0bN4cM7xZ2aJ5fG8dK1uV3oW9qR6tY0iS4eL2nB7mC5vX8zA1sD3fH6jK9lP0oI2uY4tR7eW1qA5sZ8xC3vB6nM9kL2jH5gF8dS1aP4oI7uY0tR3eW6qA9sZ2xC5vB8nM1kL4jH7gF0dS3aP6oI9uY2tR5eW8qA1sZ4xC7vB0nM3kL6\" \"jH9gF2dS5aP8oI1uY4tR7eW0qA3sZ6xC9vB2nM5kL8jH1gF4dS7aP0oI3uY6tR9eW2qA5sZ8xC1vB4nM7kL0jH3gF6dS9aP2oI5uY8tR1eW4qA7sZ0xC3vB6nM9QIDAQAB\""
          },
          "mx": {
            "type": "MX",
            "host": "acme-mail.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-mail.com"
          }
        },
        "spf_duplicate": false,
        "spf_duplicate_records": [],
        "dkim": {
          "version": 1,
          "key_size": 1024,
          "selector": "sendcorex",
          "deprecated": true,
          "upgrade_pending": true,
          "pending": {
            "selector": "sendcorex2",
            "key_size": 2048,
            "host": "sendcorex2._domainkey",
            "full_host": "sendcorex2._domainkey.acme-mail.com",
            "value": "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAw3v8Qk2Lr9sT1yH6pE0bN4cM7xZ2aJ5fG8dK1uV3oW9qR6tY0iS4eL2nB7mC5vX8zA1sD3fH6jK9lP0oI2uY4tR7eW1qA5sZ8xC3vB6nM9kL2jH5gF8dS1aP4oI7uY0tR3eW6qA9sZ2xC5vB8nM1kL4jH7gF0dS3aP6oI9uY2tR5eW8qA1sZ4xC7vB0nM3kL6jH9gF2dS5aP8oI1uY4tR7eW0qA3sZ6xC9vB2nM5kL8jH1gF4dS7aP0oI3uY6tR9eW2qA5sZ8xC1vB4nM7kL0jH3gF6dS9aP2oI5uY8tR1eW4qA7sZ0xC3vB6nM9QIDAQAB",
            "split_value": "\"v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAw3v8Qk2Lr9sT1yH6pE0bN4cM7xZ2aJ5fG8dK1uV3oW9qR6tY0iS4eL2nB7mC5vX8zA1sD3fH6jK9lP0oI2uY4tR7eW1qA5sZ8xC3vB6nM9kL2jH5gF8dS1aP4oI7uY0tR3eW6qA9sZ2xC5vB8nM1kL4jH7gF0dS3aP6oI9uY2tR5eW8qA1sZ4xC7vB0nM3kL6\" \"jH9gF2dS5aP8oI1uY4tR7eW0qA3sZ6xC9vB2nM5kL8jH1gF4dS7aP0oI3uY6tR9eW2qA5sZ8xC1vB4nM7kL0jH3gF6dS9aP2oI5uY8tR1eW4qA7sZ0xC3vB6nM9QIDAQAB\"",
            "created_at": "2026-10-21T03:10:44.205Z"
          },
          "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é.

Fonctionnement de la mise à niveau

Vos emails sont signés avec l'ancienne clé tout du long, jusqu'à ce que la nouvelle soit dans le DNS.

  • 1. Démarrer

    Cette commande. La nouvelle clé va dans dkim.pending et dns_records.dkim_pending (sélecteur sendcorex2).

  • 2. Publier

    Créez l'enregistrement TXT dkim_pending. Gardez l'ancien.

  • 3. Vérifier

    Appelez Get Domain. Dès que le nouvel enregistrement est trouvé, la nouvelle clé commence à signer (dkim.just_upgraded vaut true lors de cet appel).

  • 4. Nettoyer

    Gardez l'ancien enregistrement jusqu'à dkim.keep_old_record_until (48 heures), pour que les emails encore en transit restent valides, puis supprimez-le.

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.

  • CMDALREADY_UPGRADED

    Le domaine utilise déjà une clé 2048 bits.

  • CMDDKIM_GENERATION_FAILED

    La clé DKIM n'a pas pu être créée. Rien n'a été enregistré. Réessayez.

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