Versão da API 1.1

Esta documentação explica como registrar, configurar e desenvolver seu aplicativo para que você possa usar nossas APIs com sucesso

Criar App

Para que seu aplicativo acesse nossas APIs, você deve registrá-lo usando o Painel do aplicativo. O registro cria um ID de aplicativo que nos permite saber quem você é, nos ajuda a distinguir seu aplicativo de outros aplicativos.

1. Você precisará criar um novo aplicativo Criar novo Aplicativo
2. Depois de criar seu aplicativo, você obterá seu app_id e app_secret

Entrar com

O sistema 'Log in With' é uma maneira rápida e conveniente para as pessoas criarem contas e fazerem login no seu aplicativo. Nosso sistema 'Log in With' permite dois cenários, autenticação e solicitação de permissões para acessar os dados das pessoas. Você pode usar o sistema Login With simplesmente para autenticação ou para autenticação e acesso aos dados.

1. Iniciando o processo de login do OAuth, você precisa usar um link para seu aplicativo como este:

   <a href="https://acusticafacil.com.br/api/oauth?app_id=YOUR_APP_ID">Log in With Acústica Fácil – Rede Social para Especialistas</a>

   O usuário será redirecionado para a página de login como esta

   
2. Assim que o usuário aceitar seu aplicativo, ele será redirecionado para seu aplicativo, redirecionando a URL com auth_key assim:

   https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY

   Esse auth_key é válido apenas para um único uso. Assim Assim que for utilizado, não poderá ser usado novamente. Para gerar um novo código, será necessário redirecionar o usuário para o link de login novamente. .

Token de acesso

Depois de obter a aprovação do usuário do seu aplicativo, faça login na janela de Login e retorne com o auth_key . Isso significa que agora você está pronto para recuperar os dados necessários de nossas APIs. Para iniciar esse processo, será necessário autorizar seu aplicativo e obter o access_token . Agora siga os passos para aprender como obtê-lo.

1. Para obter um token de acesso, faça uma solicitação HTTP GET para o seguinte ponto de extremidade como este:

   <?php
   $app_id = "YOUR_APP_ID"; // your app id
   $app_secret = "YOUR_APP_SECRET"; // your app secret
   $auth_key = $_GET['auth_key']; // the returned auth key from previous step
   
   $get = file_get_contents("https://acusticafacil.com.br/api/authorize?app_id=$app_id&app_secret=$app_secret&auth_key=$auth_key");
   
   $json = json_decode($get, true);
   if(!empty($json['access_token'])) {
       $access_token = $json['access_token']; // your access token
   }
   ?>

   Esse access_token é válido apenas por uma hora. Assim que expirar, será necessário gerar um novo código, redirecionando o usuário para o link de login novamente..

APIs

Depois que você tiver o seu access_token Agora você pode recuperar informações do nosso sistema por meio de solicitações HTTP GET que suportam os seguintes parâmetros

Você pode recuperar informações do usuário assim

if(!empty($json['access_token'])) {
   $access_token = $json['access_token']; // your access token
   $get = file_get_contents("https://acusticafacil.com.br/api/get_user_info?access_token=$access_token");
}

O resultado será:

{
    "user_info": {
        "user_id": "",
        "user_name": "",
        "user_email": "",
        "user_firstname": "",
        "user_lastname": "",
        "user_gender": "",
        "user_birthdate": "",
        "user_picture": "",
        "user_cover": "",
        "user_registered": "",
        "user_verified": "",
        "user_relationship": "",
        "user_biography": "",
        "user_website": ""
    }
}