API verzija 1.1

Ova dokumentacija objašnjava kako registrovati, konfigurisati i razviti vašu aplikaciju kako biste uspješno koristili naše API-je

Kreiraj aplikaciju

Kako bi vaša aplikacija mogla pristupiti našim API-jima, morate registrovati vašu aplikaciju koristeći Kontrolna ploča aplikacije. Registracija kreira App ID koji nam omogućava da znamo ko ste, pomaže nam da razlikujemo vašu aplikaciju od drugih aplikacija.

1. Morat ćete kreirati novu aplikaciju Kreiraj novu aplikaciju
2. Nakon što kreirate vašu aplikaciju dobit ćete svoj app_id i app_secret

Prijavi se sa

Sistem 'Prijavi se sa' je brz i pogodan način da ljudi kreiraju račune i prijave se u vašu aplikaciju. Naš sistem 'Prijavi se sa' omogućava dva scenarija, autentifikaciju i traženje dozvola za pristup podacima ljudi. Možete koristiti sistem prijave jednostavno za autentifikaciju ili za oboje, autentifikaciju i pristup podacima.

1. Pokretanje OAuth procesa prijave, morate koristiti link za vašu aplikaciju kao što je ovaj:

   <a href="https://stream.ba/api/oauth?app_id=YOUR_APP_ID">Log in With Stream.ba</a>

   Korisnik će biti preusmjeren na stranicu 'Prijavi se sa' kao što je ova

   
2. Nakon što korisnik prihvati vašu aplikaciju, bit će preusmjeren na URL za preusmjeravanje vaše aplikacije sa auth_key kao ovo:

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

   Ovo auth_key važi samo za jednokratnu upotrebu, tako da nakon što ga iskoristite nećete ga moći ponovo koristiti, a za generisanje novog koda morat ćete ponovo preusmjeriti korisnika na link za prijavu.

Pristupni token

Nakon što dobijete odobrenje korisnika u prozoru 'Prijavi se sa' vaše aplikacije i vratite se sa auth_key što znači da ste sada spremni za preuzimanje podataka iz naših API-ja, a da biste započeli ovaj proces morat ćete autorizovati vašu aplikaciju i dobiti access_token i možete pratiti naše korake da naučite kako to dobiti.

1. Da biste dobili pristupni token, napravite HTTP GET zahtjev na sljedeću krajnju tačku kao što je ovo:

   <?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://stream.ba/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
   }
   ?>
   

   Ovo access_token važi samo 1 sat, tako da nakon što postane nevažeći morat ćete generisati novi preusmjeravanjem korisnika ponovo na link za prijavu.

API-ji

Kada dobijete svoj access_token Sada možete preuzeti informacije iz našeg sistema putem HTTP GET zahtjeva koji podržavaju sljedeće parametre

Možete preuzeti informacije o korisniku kao što je ovo

            if(!empty($json['access_token'])) {
                $access_token = $json['access_token']; // your access token
                $get = file_get_contents("https://stream.ba/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": ""
              }
            }