Primeiros passos com a API MemberMouse

URL e credenciais da API

A primeira coisa de que você precisa para usar a API do MemberMouse é o URL e as credenciais da API. Na seção MembroMouse menu ir para Ferramentas do desenvolvedor e clique no ícone Guia Credenciais da API. Nesta página, você pode veja seu URL de API e crie e gerencie credenciais de API.

Execução de uma chamada de 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 uma lista das chamadas de API no MemberMouse e clique em uma chamada de API para visualizar o URL associado e os parâmetros de entrada.

Faça o download do código de amostra para PHP

Abaixo está um exemplo de chamada de API para criar um novo membro usando o Chamada da API createMember.

First, we’re setting the input parameters as a string of name/value pairs separated by an & e armazenados no $inputParams variável.

Next, we’re setting the API call URL and initializing a instância cURL.

Finally, we’re executing the cURL instance, decoding the result of the call and storing it in a $data e, em seguida, enviando-a para a tela.

$inputParams = "apikey={Sua_API_Key}&apisecret={Sua_API_Secret}&";
$inputParams .= "first_name=Tom&";
$inputParams .= "last_name=Smith&"; $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 "Resposta 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 Bloqueio de solicitações

Em alguns servidores, você pode descobrir que as chamadas de API estão sendo rejeitadas pelo servidor. Isso geralmente está relacionado a configurações de segurança no servidor, como mod_security. Para contornar esse problema, você pode tentar passar cabeçalhos adicionais para a solicitação cURL para simular que ela vem de um navegador real, como segue:

$headers = 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); 

É claro que você deve substituir http://yourdomain.com pelo seu domínio real.

Acesso ao código de resposta

Na solicitação de exemplo acima, o json_decode() é usado para analisar o objeto de resultado da chamada de API e armazená-lo no $data variável. Nesse ponto, o código de resposta pode ser acessado da seguinte forma:

$data->response_code;

Veja este artigo para uma lista das chamadas de API no MemberMouse e clique em uma chamada de API para visualizar os códigos de resposta associados.

Acesso aos dados de resposta

Na solicitação de exemplo acima, o json_decode() é usado para analisar o objeto de resultado da chamada de API e armazená-lo no $data variável. Nesse ponto, os dados de resposta podem ser acessados da seguinte forma:

$data->response_data->username;
$data->response_data->password (senha);
$data->response_data->email;

Onde nome de usuário, senha e e-mail são parâmetros válidos no objeto de dados de resposta. A lista de parâmetros válidos varia de acordo com a chamada de API feita. Consulte este artigo para obter informações sobre uma lista das chamadas de API no MemberMouse e clique em uma chamada de API para visualizar os dados de resposta associados.

Baixe o código de amostra para Python