Versión de API 1.1
Esta documentación explica cómo registrar, configurar y desarrollar tu aplicación para que puedas usar con éxito nuestras API
Crear aplicación
Para que tu aplicación acceda a nuestras API, debes registrar tu aplicación utilizando el Panel de aplicaciones. El registro crea una ID de aplicación que nos permite saber quién eres tu, nos ayuda a distinguir tu aplicación de otras aplicaciones.
- Necesitarás crear una nueva aplicación Crear nueva aplicacion
- Una vez que hayas creado tu aplicación, obtendrás tu app_id y app_secret
Iniciar con
Iniciar sesión con el sistema es una forma rápida y conveniente para que las personas creen cuentas e inicien sesión en su aplicación. Nuestro sistema Iniciar sesión con permite dos escenarios, la autenticación y la solicitud de permisos para acceder a los datos de las personas. Puede usar el sistema Iniciar sesión simplemente autenticación o para autenticación y acceso a datos.
-
Al iniciar el proceso de inicio de sesión de OAuth, debe usar un enlace para su aplicación como este:
<a href="https://curiobuzz.com/api/oauth?app_id=YOUR_APP_ID">Log in With curiobuzz</a>
El usuario será redirigido a Iniciar sesión con una página como esta
-
Una vez que el usuario accedió a su aplicación, será redirigido a su URL de redireccionamiento de aplicaciones con auth_key me gusta:
https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY
Este auth_key válido sólo por un uso de una vez, por lo que una vez que lo haya utilizado no podrá utilizarlo de nuevo y generar nuevo código tendrá que redirigir al usuario al inicio de sesión con enlace de nuevo.
Ficha de acceso
Una vez que obtenga la aprobación del usuario de su aplicación, inicie sesión con la ventana y regrese con auth_key lo que significa que ahora está listo para recuperar datos de nuestras API y para comenzar este proceso deberá autorizar su aplicación y obtener el access_token puedes seguir estos pasos para comprender el funcionamiento correcto.
-
Para obtener un token de acceso, haga una solicitud HTTP GET al siguiente punto final 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://curiobuzz.com/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 } ?>
Este access_token válido solo por una hora, por lo que una vez que no sea válido, deberá generar uno nuevo redirigiendo al usuario al inicio de sesión con el enlace nuevamente.
APIs
Una vez que obtenga su access_token Ahora puede recuperar información de nuestro sistema a través de solicitudes HTTP GET que admiten los siguientes parámetros
Punto final | Descripcion |
---|---|
api/get_user_info | obtener información del usuario |
Puedes recuperar información de usuario como este
if(!empty($json['access_token'])) { $access_token = $json['access_token']; // your access token $get = file_get_contents("https://curiobuzz.com/api/get_user_info?access_token=$access_token"); }
El 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": "" } }