Vývojáři | Unity Christ Social Network

Verze API 1.1

Tato dokumentace vysvětluje, jak zaregistrovat, konfigurovat a vyvíjet vaši aplikaci, abyste mohli úspěšně používat naše API

Vytvořit aplikaci

Chcete-li, aby vaše aplikace přistupovala k našim rozhraním API, musíte svou aplikaci zaregistrovat pomocí Řídicí panel aplikace. Registrace vytvoří ID aplikace, které nám umožní zjistit, kdo jste, pomáhá nám odlišit vaši aplikaci od ostatních aplikací.

Budete si muset vytvořit novou aplikaci Vytvořit novou App\
Jakmile vytvoříte aplikaci, dostanete ji app_id a app_secret

Přihlásit se s

Přihlásit se systémem je rychlý a pohodlný způsob, jak lidé vytvářejí účty a přihlašují se do aplikace. Náš systém Přihlásit se umožňuje dva scénáře, autentizaci a žádost o povolení přístupu k datům lidí. Přihlásit se systémem můžete jednoduše pro autentizaci nebo pro autentizaci a přístup k datům.

Chcete-li zahájit proces přihlášení k protokolu OAuth, musíte pro svou aplikaci použít odkaz jako je tento:
```
<a href="https://social.unitychrist.org/api/oauth?app_id=YOUR_APP_ID">Log in With Unity Christ Social Network</a>
```
Uživatel bude přesměrován na stránku Přihlásit se, jako je tato
Jakmile uživatel vaši aplikaci schválí, bude přesměrován pomocí adresy URL na přesměrování aplikace auth_key se to líbí:
```
https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY
```
Tento auth_key platí pouze pro jednorázové použití, takže jakmile jej použijete, nebudete jej moci znovu použít a vygenerovat nový kód, budete muset uživatele přesměrovat k přihlášení znovu pomocí odkazu.

Přístupový token

Jakmile uživatel získá schválení vaší aplikace, přihlaste se pomocí okna a vraťte se pomocí auth_key což znamená, že nyní jste připraveni načíst data z našich rozhraní API a zahájit tento proces, musíte aplikaci autorizovat a získat access_token a můžete postupovat podle našich kroků, abyste zjistili, jak je získat.

Chcete-li získat přístupový token, zadejte požadavek HTTP GET na následující koncový bod, jako 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://social.unitychrist.org/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 platí pouze po dobu jedné hodiny, takže jakmile se stane neplatnou, budete muset genovat novou, přesměrováním uživatele na přihlášení znovu s odkazem.

API

Jakmile dostanete váš access_token Nyní můžete načíst informace z našeho systému prostřednictvím požadavků HTTP GET, které podporují následující parametry

Koncový bod	Popis
api/get_user_info	získat informace o uživateli

Takto můžete získat informace o uživateli

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

Výsledkem 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": ""
              }
            }