Primeros pasos con la API MemberMouse

URL y credenciales de la API

Lo primero que necesita para utilizar la API de MemberMouse es la URL de la API y las credenciales. En la MemberMouse menú ir a Herramientas para desarrolladores y haga clic en el botón Ficha Credenciales API. En esta página, puede ver su URL API y crear y gestionar credenciales API.

Ejecución de una llamada a la API

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 una lista de las llamadas a la API en MemberMouse y haga clic en una llamada a la API para ver la URL asociada y los parámetros de entrada.

Descargar código de ejemplo para PHP

A continuación se muestra un ejemplo de llamada a la API para crear un nuevo miembro utilizando la función Llamada a la API createMember.

First, we’re setting the input parameters as a string of name/value pairs separated by an & y se almacena en el $inputParams variable.

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

Finally, we’re executing the cURL instance, decoding the result of the call and storing it in a $data y luego mostrarlo en la pantalla.

$inputParams = "apikey={Su_Clave_API}&apisecret={Su_Secreto_API}&";
$inputParams .= "first_name=Tom&";
$inputParams .= "last_name=Smith&";
$inputParams .= "[email protected]&";
$inputParams .= "phone=(212) 555-7864&";
$inputParams .= "membership_level_id=2&";

$apiCallUrl = "https://{Your_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 "Respuesta RAW: ".$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 Bloqueo de peticiones

En algunos servidores es posible que las llamadas a la API sean rechazadas por el servidor. Esto suele estar relacionado con la configuración de seguridad del servidor, como mod_security. Para evitar esto, puede intentar pasar cabeceras adicionales a la solicitud cURL para simular que proviene de un navegador real de la siguiente manera:

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

Por supuesto, deberá sustituir http://yourdomain.com por su dominio real.

Acceso al código de respuesta

En el ejemplo de solicitud anterior json_decode() se utiliza para analizar el objeto resultante de la llamada a la API y almacenarlo en el archivo $data variable. En este punto, se puede acceder al código de respuesta de la siguiente manera:

$data->código_respuesta;

Consulte este artículo para una lista de las llamadas a la API en MemberMouse y haga clic en una llamada a la API para ver los códigos de respuesta asociados.

Acceso a los datos de respuesta

En el ejemplo de solicitud anterior json_decode() se utiliza para analizar el objeto resultante de la llamada a la API y almacenarlo en el archivo $data variable. En este punto, se puede acceder a los datos de respuesta de la siguiente manera:

$data->response_data->nombre_usuario;
$data->response_data->contraseña;
$data->response_data->email;

Dónde nombre de usuario, contraseña y correo electrónico son parámetros válidos en el objeto de datos de respuesta. La lista de parámetros válidos variará en función de la llamada a la API realizada. Consulte este artículo para una lista de las llamadas a la API en MemberMouse y haga clic en una llamada a la API para ver los datos de respuesta asociados.

Descargar código de ejemplo para Python