Erste Schritte mit der MemberMouse-API

API-URL und Anmeldeinformationen

Um die MemberMouse-API verwenden zu können, benötigen Sie zunächst die API-URL und die Anmeldedaten. In der MitgliedMaus Menü gehen zu Entwickler-Tools und klicken Sie auf das Registerkarte API-Anmeldeinformationen. Auf dieser Seite können Sie Ihre API-URL einsehen und API-Anmeldeinformationen erstellen und verwalten.

Ausführen eines API-Aufrufs

In order to make an API call you’ll need to make a request to the API call URL and pass the appropriate input parameters. The API call URL and input parameters will vary based on the API call being made. See this article for eine Liste der API-Aufrufe in MemberMouse und klicken Sie auf einen API-Aufruf, um die zugehörige URL und die Eingabeparameter anzuzeigen.

Beispielcode für PHP herunterladen

Nachfolgend ein Beispiel für einen API-Aufruf zur Erstellung eines neuen Mitglieds unter Verwendung der createMember API-Aufruf.

First, we’re setting the input parameters as a string of name/value pairs separated by an & und gespeichert in der $inputParams variabel.

Next, we’re setting the API call URL and initializing a cURL-Instanz.

Finally, we’re executing the cURL instance, decoding the result of the call and storing it in a $data und gibt sie dann auf dem Bildschirm aus.

$inputParams = "apikey={Ihr_API_Key}&apisecret={Ihr_API_Geheimnis}&";
$inputParams .= "vorname=Tom&";
$inputParams .= "nachname=Schmied&";
$inputParams .= "[email protected]&";
$inputParams .= "Telefon=(212) 555-7864&";
$inputParams .= "mitgliedschaft_level_id=2&";

$apiCallUrl = "https://{Ihre_API_URL}?q=/createMember";
$ch = curl_init($apiCallUrl);

curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $inputParams);
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$result = curl_exec($ch);
curl_close($ch);

echo "RAW-Antwort: ".$result."<br />";
$data = json_decode($result);
echo "<pre>";
var_dump($data-&gt;Response_data);
echo "</pre>"; 

To modify this for different API calls you’ll need to change the API call URL and input parameters according to the documentation for the API call you’re making.

mod_security Blockieren von Anfragen

Auf manchen Servern kann es vorkommen, dass API-Aufrufe vom Server abgewiesen werden. Dies hängt in der Regel mit den Sicherheitseinstellungen des Servers zusammen, z. B. mod_security. Um dies zu umgehen, können Sie versuchen, zusätzliche Header an die cURL-Anfrage zu übergeben, um zu simulieren, dass sie von einem echten Browser kommt, wie folgt:

$headers = array(
'Referrer: http://yourdomain.com',
'Benutzer-Agent: Mozilla/5.0 (X11; Ubuntu; Linux i686; rv:28.0) Gecko/20100101 Firefox/28.0'
);
curl_setopt($ch,CURLOPT_HTTPHEADER,$headers); 

Natürlich sollten Sie http://yourdomain.com durch Ihre eigentliche Domäne ersetzen.

Zugriff auf den Antwortcode

In der obigen Beispielanforderung ist die json_decode() Methode wird verwendet, um das Ergebnisobjekt des API-Aufrufs zu analysieren und es in der $data Variable. An dieser Stelle kann auf den Antwortcode wie folgt zugegriffen werden:

$data->Antwort_code;

Siehe diesen Artikel für eine Liste der API-Aufrufe in MemberMouse und klicken Sie auf einen API-Aufruf, um die zugehörigen Antwortcodes anzuzeigen.

Zugriff auf Antwortdaten

In der obigen Beispielanforderung ist die json_decode() Methode wird verwendet, um das Ergebnisobjekt des API-Aufrufs zu analysieren und es in der $data Variable. An dieser Stelle kann auf die Antwortdaten wie folgt zugegriffen werden:

$data->Antwort_data->Benutzername;
$data->Antwort_data->Passwort;
$data->response_data->email;

Wo Nutzername, Passwort und E-Mail sind gültige Parameter im Antwortdatenobjekt. Die Liste der gültigen Parameter hängt vom jeweiligen API-Aufruf ab. Siehe diesen Artikel für eine Liste der API-Aufrufe in MemberMouse und klicken Sie auf einen API-Aufruf, um die zugehörigen Antwortdaten anzuzeigen.

Beispielcode für Python herunterladen