Versão 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 Gerenciador de App. O Cadastro gera um ID de Aplicativo que nos permite saber quem você é e nos ajuda a diferenciar seu aplicativo de outros aplicativos..

1. Você precisará criar um Novo Aplicativo. Criar Novo App
2. Depois de criar Seu Aplicativo, você receberá seu app_id e app_secret

Fazer Login com

O sistema 'Login Com' é uma maneira rápida e conveniente para as pessoas criarem Conta.

1. Para iniciar o Processo de Login OAuth, você precisa usar um link para Seu Aplicativo, como por exemplo: este:

   <a href="https://pranegocio.com/api/oauth?app_id=YOUR_APP_ID">Log in With PraNegocio</a>

   O Usuário será redirecionado para uma Página de Login como esta.

   
2. Assim que o Usuário aceitar Seu Aplicativo, ele será redirecionado para ele. Redirecionar URL com auth_key Como Este:

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

   Isto auth_key Válido apenas para uso único, portanto, depois de usá-lo, você não poderá usá-lo novamente e gerar um Novo Código. Você precisará redirecionar o Usuário para o Link de Login novamente.

Token de Acesso

Após obter a Aprovação do Usuário para o Seu Aplicativo, faça Login na janela e retorne com o auth_key O que significa que agora você está pronto para Recuperar Dados de nossas APIs e parapara iniciar este processo, você precisará Autorizar Seu Aplicativo e obter o access_token e você pode seguir Nossos Passos para aprender como obtê-lo..

1. Para obter um Token de Acesso, faça uma Solicitação HTTP GET para o seguinte endpoint.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
   
           // Prepare the POST data
           $postData = [
             'app_id' => $app_id,
             'app_secret' => $app_secret,
             'auth_key' => $auth_key
           ];
   
           // Initialize cURL
           $ch = curl_init('https://pranegocio.com/api/authorize');
   
           // Set cURL options for POST
           curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
           curl_setopt($ch, CURLOPT_POST, true);
           curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($postData));
   
           // Execute request
           $response = curl_exec($ch);
   
           // Check for cURL errors
           if (curl_errno($ch)) {
             die('cURL error: ' . curl_error($ch));
           }
   
           curl_close($ch);
   
           // Decode the JSON response
           $json = json_decode($response, true);
   
           // Use the access token if available
           if (!empty($json['access_token'])) {
             $access_token = $json['access_token']; // your access token
           }
           ?>
           

   Isto access_token Válido apenas por 1 hora, portanto, após expirar, você precisará...gerar uma Nova Conta redirecionando o Usuário para a Página de Login com o Link novamente..

APIs

Assim que você receber o seu access_token Agora você pode recuperar informações do seu sistema por meio de solicitações HTTP GET.que suporta os seguintes parâmetros

Você pode Recuperar Informações do Usuário desta forma.

        if(!empty($json['access_token'])) {
            $access_token = $json['access_token']; // your access token
            $get = file_get_contents("https://pranegocio.com/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": ""
          }
        }