Documentation de Maildrop

Subscriber.ImportBatch

URL https://api.dpmail.fr/json/Subscriber.ImportBatch.php

Permet d'importer un grand nombre de contacts dans une liste en une seule fois. Cette méthode devrait être appelée en utilisant la méthode POST à la place de GET. Le nombre maximal d'abonnés importés n'est pas fixé, cependant la taille raisonnable de chaque appel doit être d'environ 5000 à 10000 lignes. Ces appels peuvent être longs, mais ne doivent pas excéder 30 secondes, sinon vous recevrez un timeout.

Pour importer un grand nombre de contacts sans risquer de recevoir un timeout, vous pouvez utiliser Subscriber.ImportByUrl qui permet de réaliser des imports asynchrones.

Paramètres et infos requises

ListId - String
L'identifiant de la liste à laquelle ajouter les abonnés.

Batch - JsonString
Une chaine en JSON représentant un tableau d'objet. Voir la description ci-dessous.

Options - Array
Un tableau d'option permettant d'adapter le fonctionnement de l'import:

Options disponibles :

  • update_existing (défaut: true) : Si l'adresse email existe déjà dans la liste, les données du contact seront mises à jour.
  • resubscribe (défaut: false) : Si l'adresse email correspond a un contact désinscrit de la liste, il sera ré-inscrit.

Codes de retour

Succès

0: Success
Les données sont correctes, l'import va se réaliser d'ici quelques instants.

Erreur

11: Format JSON illisible
Le format JSON du paramètre Batch est illisible/indécodable.

301: ListID Invalide
ListID doit être une chaine de 32 caractères. La liste dans laquelle vous voulez importer les abonnés doit appartenir au compte lié à votre clé API.

316: Batch est vide
Le paramètre Batch a été reçu vide. Aucune action n'a été réalisée.

Format de données en entrée pour le paramètre "Batch"

[
  {
    "email" : "azer@uipo.tld",
    "first_name" : "Bérenger",
    "customs_fields" : {
      "ville" : "Toulouse",
      "codep" : 31000
    }
  }, {
    "email" : "qwerty@uipo.tld",
    "first_name" : "David",
    "customs_fields" : {
      "ville" : "Castres",
      "codep" : 81100
    }
  }, ...
]

Format des données en sortie

{
  "add_count" : 613,
  "adds" : [
    "azer@uipo.tld",
    "..."
  ],
  "update_count" : 254,
  "updates" : [
    "qwerty@uipo.tld",
    "..."
  ],
  "error_count" : 0,
  "errors" : []
}