Dokumentácia

API Verzia 1.1

Táto dokumentácia vysvetľuje, ako zaregistrovať, nakonfigurovať a vyvinúť vašu aplikáciu, aby ste mohli úspešne používať naše rozhrania API

Vytvor aplikáciu

Ak chcete, aby vaša aplikácia mala prístup k našim rozhraniam API, musíte ju zaregistrovať pomocou nástroja Panel aplikácie. Registrácia vytvorí ID aplikácie, ktoré nám dá vedieť, kto ste, a pomôže nám rozlíšiť vašu aplikáciu od iných aplikácií.

  1. Budete musieť vytvoriť novú aplikáciu Vytvor novú aplikáciu
  2. Po vytvorení aplikácie dostanete svoje app_id a app_secret
Prihlásiť sa s

Prihlásiť sa pomocou systému je rýchly a pohodlný spôsob, ako si ľudia môžu vytvoriť účty a prihlásiť sa do vašej aplikácie. Náš systém Prihlásiť sa pomocou umožňuje dva scenáre, autentifikáciu a žiadanie o povolenia na prístup k údajom ľudí. Systém Login With môžete použiť jednoducho na autentifikáciu alebo na autentifikáciu aj prístup k dátam.

  1. Spustenie procesu prihlásenia OAuth, musíte použiť odkaz na vašu aplikáciu, ako je tento:
    <a href="https://siet.elektrolab.eu/api/oauth?app_id=YOUR_APP_ID">Log in With Sieť</a>

    Používateľ bude presmerovaný na stránku Prihlásiť sa pomocou, ako je táto

  2. Keď používateľ prijme vašu aplikáciu, bude presmerovaný na vašu adresu URL presmerovania aplikácie s auth_key vyzerajúcej takto:
    https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY
    Tento auth_key platí len na jedno použitie, takže ak ho použijete, nebudete ho môcť znova použiť a vygenerovať nový kód, budete musieť znova presmerovať používateľa na prihlásenie pomocou odkazu.
Prístupový token

Po získaní súhlasu používateľa s vašou aplikáciou sa okno Prihláste sa pomocou a vrátite sa s auth_key čo znamená, že teraz ste pripravení načítať údaje z našich rozhraní API a na spustenie tohto procesu budete musieť autorizovať svoju aplikáciu a získať access_token a môžete postupovať podľa našich krokov, aby ste sa naučili, ako ho získať.

  1. Ak chcete získať prístupový token, zadajte požiadavku HTTP GET na nasledujúci koncový bod, ako je tento:
    <?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://siet.elektrolab.eu/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
        }
        ?>
    Tento access_token platný iba jednu hodinu, takže akonáhle sa stane neplatným, budete musieť vytvoriť nový presmerovaním používateľa na prihlásenie pomocou odkazu znova.
API

Akonáhle dostanete svoje access_token Teraz môžete získať informácie z nášho systému prostredníctvom požiadaviek HTTP GET, ktoré podporujú nasledujúce parametre

Koncový bod Popis
api/get_user_info

získať informácie o používateľovi

Informácie o používateľovi môžete získať takto

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

Výsledkom bude:

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