Wie kann ich mit der Mailify API Daten in meine Kontaktliste importieren?

Um die Mailify API nutzen zu können, muss erst die "php_curl"-Erweiterung in Ihrem PHP Setup aktiviert sein.(Daten php.ini)

Jetzt geht's los!

Da gewisse Daten sich immer ähnlich sind, wann auch immer die API diese aufruft, macht es Sinn, die PHP-Funktion am Anfang der Datei zu kopieren um so die ersten Zeilenreihen zu erstellen und sie einfacher mit der API zu verbinden.

<?php   
function post_to_url($url, $data) {
   $fields = '';
   foreach($data as $key => $value) {
      $fields .= $key . '=' . $value . '&';
   }
   rtrim($fields, '&');

   $post = curl_init();
   curl_setopt($post, CURLOPT_URL, $url);
   curl_setopt($post, CURLOPT_POST, count($data));
   curl_setopt($post, CURLOPT_POSTFIELDS, $fields);
   curl_setopt($post, CURLOPT_RETURNTRANSFER, 1);

   $result = curl_exec($post);

   curl_close($post);
} 
?>

Wie Sie sehen können, braucht diese Funktion zwei Faktoren, um aufgerufen zu werden:

• Eine URL ($url)
• Daten($data)

Sie finden die URL in der Mailify Applikation, wenn Sie bei den einzelnen Kontaktlisten rechts auf das Piktogramm "API Zugriff* klicken. 

/!\ Falls diese Option nicht erscheint, überprüfen Sie, dass die API-Erweiterung im Menü "Erweiterungen" aktiviert wurde. Menü "Erweiterungen"(1) und "API Kontaktliste"(2).

Klicken Sie auf "API Zugriff" in einer bereits erstellten Kontaktliste. Ein Fenster öffnet sich, das erklärt, wie Sie Kontakte mit der entsprechenden URLs hinzufügen, ändern und löschen können.

Um sich an die API anzubinden, werden wir die URL von der Kontaktliste nutzen ($url). Kopieren Sie die URL, die unten in diesem Formular angezeigt wird und fügen Sie sie im Fenster "API Zugang" ein.

Wir brauchen nur einen Teil der URL, sodass sie wie folgt aussieht:

(alles, was nach dem "?" kommt, wurde gelöscht)

Dann erhalten wir:

<?php   
$url = "https://api-sd.sarbacane.com/lists/325/7CsS69R44UaSy7TazcRLMw";  
?>

Nun müssen wir Daten ($data) senden, die dieser Liste hinzugefügt werden sollen:

$data ist eine Tabelle mit Daten, die wie folgt aussieht:

<?php   

$data=array(  
  'action' => 'INSERT',
  'Email' => $email  );  

?>

/!\ In diesem Beispiel wurde $email bereits mit einer E-Mail-Adresse aufgesetzt.

Die Schaltfläche "Aktion" ist notwendig, da Sie damit definieren, was mit diesen Daten geschehen soll.

Drei Werte sind möglich: 'INSERT', 'UPDATE', 'DELETE'.
Das HTML-Formular im Beispiel beinhaltete nur eine "E-Mail"-Box, somit enthält die $data Tabelle nur die "E-Mail"-Box.

/!\ Standardmässig enthält eine Kontaktliste nur die Spalte "E-Mail": Wenn Sie Ihrer Liste weitere Spalten hinzufügen, müssen Sie diese auch in Ihren Listen nachtragen und Sie in der $data Tabelle anfügen.

Hier ein Beispiel mit "E-Mail", "Vorname" und "Nachname":

<?php   

$data=array(  
    'action' => 'INSERT',  
    'Email' => $email,  
    'Vorname' => $vorname,  
    'Name' => $name); 

?>

Sobald alle Werte in der '$data' Tabelle eingefügt sind, können Sie sie mit folgendem Befehl an die API senden:

<?php   
post_to_url($url, $data);  
?>

Ihre Daten wurden nun Ihren Kontaktlisten hinzugefügt.
/!\ Mailify aktualisiert Ihre Kontaktlisten alle 4 Minuten. Um ein Update zu erzwingen, starten Sie die Software neu.

Zusammenfassung der PHP-Code-Datei

<?php   
function post_to_url($url, $data) {
   $fields = '';
   foreach($data as $key => $value) {
      $fields .= $key . '=' . $value . '&';
   }
   rtrim($fields, '&');

   $post = curl_init();
   curl_setopt($post, CURLOPT_URL, $url);
   curl_setopt($post, CURLOPT_POST, count($data));
   curl_setopt($post, CURLOPT_POSTFIELDS, $fields);
   curl_setopt($post, CURLOPT_RETURNTRANSFER, 1);

   $result = curl_exec($post);

   curl_close($post);
}  

//Nun erhalten wir die Daten, die gesendet werden sollen:  
$url = "https://api-sd.sarbacane.com/lists/325/7CsS69R44UaSy7TazcRLMw";  
$email = $_POST["email"];    

$data=array(  
    'action' => 'INSERT',  
    'Email' => $email  
);    

//Sendung der Daten  
post_to_url($url, $data);  
?>