Siblia

Desenvolvedores

Explore as ferramentas para desenvolvedores que oferecemos

Esta documentação explica como registrar, configurar e desenvolver seu aplicativo para usar nossas APIs

Versão da API 1.1

Criar aplicativo

Para que seu aplicativo acesse nossas APIs, você precisa registrá-lo usando o Painel do aplicativo. O registro cria um ID de aplicativo que nos informa quem você é e ajuda a diferenciar seu aplicativo dos demais.

  1. 1
    Você precisa criar um novo aplicativo Criar novo aplicativo
  2. 2
    Depois de criar seu aplicativo, você receberá seu app_id e app_secret

Entrar com

O sistema Entrar com é uma forma rápida e prática de as pessoas criarem contas e entrarem no seu aplicativo. Ele permite dois cenários: autenticação e solicitação de permissões para acessar os dados das pessoas. Você pode usar o sistema Entrar com apenas para autenticação ou para autenticação e acesso a dados.

  1. 1 Para iniciar o processo de login OAuth, use um link para seu aplicativo como este:
    HTML
    <a href="https://siblia.com/api/oauth?app_id=YOUR_APP_ID">Log in With Siblia</a>
    O usuário será redirecionado para a página Entrar com, como esta
  2. 2 Quando o usuário aceitar seu aplicativo, ele será redirecionado para a URL de redirecionamento do aplicativo com o auth_key assim:
    URL
    https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY
    Este auth_key é válido para um único uso. Depois de usá-lo, não será possível usá-lo novamente; para gerar um novo código, redirecione o usuário para o link Entrar com outra vez.

Token de acesso

Depois que o usuário aprovar seu aplicativo na janela Entrar com e retornar com o auth_key você já pode obter dados das nossas APIs. Para isso, autorize seu aplicativo e obtenha o access_token e você pode seguir nossos passos para saber como obtê-lo.

Para obter um token de acesso, faça uma requisição HTTP GET para o endpoint a seguir, assim:
PHP
<?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
}
?>
Este access_token é válido por apenas 1 hora. Quando expirar, gere um novo redirecionando o usuário para o link Entrar com outra vez.

APIs

Depois de obter seu access_token você já pode obter informações do nosso sistema por meio de requisições HTTP GET, que aceitam os seguintes parâmetros

GET /api/get_user_info obter informações do usuário
Você pode obter as informações do usuário assim
PHP
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");
}
O resultado será:
JSON
{
  "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": ""
  }
}
© 2026 Siblia