Programadores

Para que a tua aplicação possa aceder às nossas APIs, tens de a registar através do Painel de controlo de aplicações. O registo cria um ID da aplicação que nos permite saber quem és e ajuda-nos a distinguir a tua aplicação das outras.

1. 1
   Tens de criar uma nova aplicação Criar nova aplicação
2. 2
   Depois de criares a tua aplicação, vais receber o teu app_id e app_secret

O sistema Iniciar sessão com é uma forma rápida e prática de as pessoas criarem contas e iniciarem sessão na tua aplicação. O nosso sistema Iniciar sessão com permite dois cenários: autenticação e pedido de permissões para aceder aos dados das pessoas. Podes usá-lo apenas para autenticação ou para autenticação e acesso a dados.

1. 1 Para iniciar o processo de início de sessão OAuth, tens de usar uma ligação para a tua aplicação como esta:
   HTML Copiar

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

   O utilizador será redirecionado para uma página Iniciar sessão com como esta
   
2. 2 Quando o utilizador aceitar a tua aplicação, será redirecionado para o URL de redirecionamento da tua aplicação com o auth_key desta forma:
   URL Copiar

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

   Este auth_key é válido para uma única utilização. Depois de o usares, não o podes voltar a usar e, para gerar um novo código, tens de redirecionar novamente o utilizador para a ligação Iniciar sessão com.

Quando o utilizador aprovar a tua aplicação na janela Iniciar sessão com e regressares com o auth_key isso significa que já podes obter dados das nossas APIs. Para iniciar este processo, tens de autorizar a tua aplicação e obter o access_token e podes seguir os nossos passos para saberes como o obter.

<?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://siblia.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));
}

// 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
}
?>

Quando obtiveres o teu access_token já podes obter informações do nosso sistema através de pedidos HTTP GET, que suportam os seguintes parâmetros

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

{
  "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": ""
  }
}