Versión API 1.1

Esta documentación explica cómo registrar, configurar y desarrollar su aplicación para que pueda utilizar con éxito nuestras API

Crear App

Para que su aplicación acceda a nuestras API, debe registrar su aplicación utilizando el Panel de aplicaciones. El registro crea una ID de aplicación que nos permite saber quién es usted y nos ayuda a distinguir su aplicación de otras aplicaciones..

  1. Necesitarás crear una nueva aplicación Crear nueva aplicación
  2. Una vez que haya creado su aplicación, obtendrá su app_id and 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, autenticación y solicitud de permisos para acceder a los datos de las personas. Puede utilizar el sistema Iniciar sesión con simplemente para autenticación o tanto para autenticación como para acceso a datos.

  1. Al iniciar el proceso de inicio de sesión de OAuth, debe usar un enlace para su aplicación como este:
    <a href="https://villenainteresa.com/api/oauth?app_id=YOUR_APP_ID">Log in With Villenainteresa</a>

    El usuario será redirigido a Iniciar sesión con una página como esta

  2. Una vez que el usuario aceptó su aplicación, el usuario será redirigido a su URL de redireccionamiento de la aplicación con auth_key Me gusta esto:
    https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY
    Esto auth_key válido solo para un uso único, por lo que una vez que lo usó no podrá volver a usarlo y generar un nuevo código, deberá redirigir al usuario al inicio de sesión con el enlace nuevamente.
Para obtener un token de acceso, realice una solicitud HTTP GET al siguiente punto final como este

Una vez que obtenga la aprobación del usuario de su aplicación, inicie sesión con la ventana y regrese con la auth_key lo que significa que ahora está listo para recuperar datos de nuestras API y para iniciar este proceso, deberá autorizar su aplicación y obtener la access_token y puedes seguir nuestros pasos para aprender cómo conseguirlo.

  1. Para obtener un token de acceso, realice 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://villenainteresa.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
    }
    ?>
    Esto access_token válido solo por una hora, por lo que una vez que se vuelva inválido, deberá generar uno nuevo redirigiendo al usuario al inicio de sesión con el enlace nuevamente.
lo que significa que ahora está listo para recuperar datos de nuestras API y para iniciar este proceso, deberá autorizar su aplicación y obtener la

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 Descripción
api/get_user_info

obtener información de usuario

Puede recuperar información de usuario como esta

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

El resultado sera:

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