Documentation de Maildrop

SendingDomains.Update

URL https://api.dpmail.fr/json/SendingDomains.Update.php

Mise à jour d'un nom de domaines expéditeurs configurés sur le compte.

Paramètres et infos requises

id - Integer
L'identifiant du domaine à mettre à jour.

returnpath_domain - Integer
Optionnel. Le nom d'hôte qui sera utilisé comme MAIL FROM, aussi visible dans l'entête Return-Path des emails envoyés.
Ce nom d'hôte doit être un sous-domaine de celui choisi pour le paramètre domain.

Si ce paramètre est absent de la requête, la valeur existante ne sera pas changée.
Si ce paramètre est vide dans la requête, la valeur existante sera remise à zéro
et le domaine de return path par défaut sera utilisé pour vos envois.

tracking_domain - String
Optionnel. Le nom d'hôte qui sera utilisé dans les emails envoyés par cet expéditeur pour le suivi statistaique.
Ce nom domaine de tracking doit au préalable avoir été créé dans votre compte.

Si ce paramètre est absent de la requête, la valeur existante ne sera pas changée.
Si ce paramètre est vide dans la requête, la valeur existante sera remise à zéro
et le domaine de return path par défaut sera utilisé pour vos envois.

storage_domain - String
Optionnel. Le nom d'hôte qui sera utilisé dans les emails envoyés par cet expéditeur pour les URL de stockage des assets de vos campagnes (images et fichiers joints par exemple).
Ce nom domaine doit au préalable avoir été créé dans votre compte.

Si ce paramètre est absent de la requête, la valeur existante ne sera pas changée.
Si ce paramètre est vide dans la requête, la valeur existante sera remise à zéro
et le domaine de return path par défaut sera utilisé pour vos envois.

Format des données en sortie

Un objet représentant le domaine expéditeur mis à jour.

{
  "id": 126,
  "domain": "dpmail.fr",
  "returnpath_domain": "md.dpmail.fr",
  "tracking_domain": {
    "id": 77,
	"domain": "link.dpmail.fr"
  },
  "storage_domain": null,  
  "status": {
    "dkim_status": "OK",
    "dkim_error": "",
    "dkim_last_verification": "2020-10-10T23:59:59+02:00",
    "returnpath_status": "PENDING",
    "returnpath_error": "",
    "returnpath_last_verification": null	
  },
  "dns_records": {
    "dkim_txt": {
	  "type": "TXT",
	  "host": "dpmail-a123456-20201010._domainkey.dpmail.fr.",
	  "value": "v=DKIM1; k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQ[...]IvnPAtRYFrmUmY3GCCthGMkQQIDAQAB"
	},
    "returnpath_cname": {
	  "type": "CNAME",
	  "host": "sender.dpmail.fr.",
	  "value": "returnpath.dpmail.fr."
	}	
  }
}