API verzija 1.1

Ova dokumentacija objašnjava kako registrirati, konfigurirati i razviti svoju aplikaciju kako biste mogli uspješno koristiti naše API-je

Stvorite aplikaciju

Da bi vaša aplikacija mogla pristupiti našim API-jima, morate registrirati svoju aplikaciju pomoću Nadzorna ploča aplikacije. Registracija stvara ID aplikacije koji nam daje do znanja tko ste, pomaže nam razlikovati vašu aplikaciju od drugih aplikacija.

1. Morat ćete izraditi novu aplikaciju Izrada nove aplikacije
2. Nakon što izradite svoju aplikaciju, dobit ćete svoju app_id i app_secret

Prijavite se s

Sustav Prijava je brz i praktičan način za stvaranje računa i prijavu u vašu aplikaciju. Naš sustav Prijava omogućuje dva scenarija: autentifikaciju i traženje dopuštenja za pristup podacima korisnika. Sustav Prijava možete koristiti samo za autentifikaciju ili za autentifikaciju i pristup podacima..

1. Započinjući postupak prijave na OAuth, morate upotrijebiti vezu za svoju aplikaciju poput ove:

   <a href="https://virtuala.site/api/oauth?app_id=YOUR_APP_ID">Log in With Virtuala FansOnly </a>

   Korisnik će biti preusmjeren na stranicu Log in With poput ove

   
2. Nakon što korisnik prihvati vašu aplikaciju, korisnik će biti preusmjeren na vaš URL za preusmjeravanje aplikacije s auth_key lajkaj:

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

   Ovaj auth_key vrijedi samo za jednokratnu upotrebu, tako da kada ga jednom upotrijebite, nećete ga moći ponovno koristiti i generirati novi kod morat ćete preusmjeriti korisnika na ponovno prijavu s vezom.

Pristupni token

Nakon što dobijete odobrenje korisnika za svoju aplikaciju Prijavite se s prozorom i vratite se s auth_key što znači da ste sada spremni za preuzimanje podataka iz naših API-ja i da biste započeli ovaj proces, morat ćete autorizirati svoju aplikaciju i dobiti access_token i možete slijediti naše korake kako biste saznali kako ga dobiti.

1. Da biste dobili pristupni token, uputite HTTP GET zahtjev sljedećoj krajnjoj točki poput ove:

   <?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://virtuala.site/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));
   }
   
   curl_close($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
   }
   ?>
   

   Ovaj access_token vrijedi samo jedan sat, tako da kada postane nevažeća, morat ćete generirati novu preusmjeravanjem korisnika na prijavu s vezom..

API-ji

Nakon što dobijete svoje access_token Sada možete dohvatiti informacije iz našeg sustava putem HTTP GET zahtjeva koji podržavaju sljedeće parametre

Podatke o korisniku možete dohvatiti ovako

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

Rezultat će biti:

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