Desarrolladores
Explora las herramientas para desarrolladores que ofrecemos
Esta documentación explica cómo registrar, configurar y desarrollar tu aplicación para que puedas usar nuestras API
Versión de la API 1.1Crear aplicación
Para que tu aplicación pueda acceder a nuestras API, debes registrarla en el Panel de aplicaciones. Al registrarla se crea un ID de aplicación que nos permite saber quién eres y distinguir tu aplicación de las demás.
-
1
Tendrás que crear una aplicación Crear aplicación
-
2
Cuando hayas creado tu aplicación, obtendrás tu
app_idyapp_secret
Iniciar sesión con
El sistema Iniciar sesión con es una forma rápida y cómoda de que las personas creen cuentas e inicien sesión en tu aplicación. Permite dos casos de uso: la autenticación y la solicitud de permisos para acceder a los datos de las personas. Puedes usarlo solo para la autenticación o para la autenticación y el acceso a datos a la vez.
-
1
Para iniciar el proceso de inicio de sesión con OAuth, debes usar un enlace de tu aplicación como este:
El usuario será redirigido a una página de Iniciar sesión con como estaHTML
<a href="https://siblia.com/api/oauth?app_id=YOUR_APP_ID">Log in With Siblia</a>
-
2
Cuando el usuario acepte tu aplicación, será redirigido a la URL de redirección de tu aplicación con el
auth_keyde esta forma:URLhttps://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEYEsteauth_keysolo es válido para un único uso: una vez utilizado, no podrás volver a usarlo y, para generar un código nuevo, tendrás que redirigir de nuevo al usuario al enlace de Iniciar sesión con.
Token de acceso
Cuando el usuario apruebe tu aplicación en la ventana de Iniciar sesión con y vuelva con el auth_key ya puedes obtener datos de nuestras API. Para empezar, tienes que autorizar tu aplicación y obtener el access_token y puedes seguir estos pasos para saber cómo obtenerlo.
<?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
}
?>
access_token solo es válido durante 1 hora; cuando caduque, tendrás que generar uno nuevo redirigiendo de nuevo al usuario al enlace de Iniciar sesión con.
API
Cuando tengas tu access_token ya puedes obtener información de nuestro sistema mediante peticiones HTTP GET, que admiten los siguientes parámetros
/api/get_user_info
obtener la información del usuario
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": ""
}
}