የኤፒአይ ስሪት 1.1

የእኛን APIs በተሳካ ሁኔታ ለመጠቀም እንዲችሉ ይህ ሰነድ መተግበሪያዎን እንዴት መመዝገብ ፣ ማዋቀር እና ማዳበር እንደሚችሉ ያብራራል

መተግበሪያ ፍጠር

የእርስዎ መተግበሪያ የእኛን APIs ለመድረስ እንዲቻል ፣ መተግበሪያዎን ማስመዝገብ አለብዎት የመተግበሪያ ዳሽቦርድ. ምዝገባ እርስዎ ማን እንደሆኑ እንድናውቅ የሚያስችል የመተግበሪያ መታወቂያ ይፈጥራል ፣ መተግበሪያዎን ከሌሎች መተግበሪያዎች ለመለየት ይረዳናል.

1. አዲስ መተግበሪያ መፍጠር ያስፈልግዎታል አዲስ መተግበሪያ ፍጠር
2. አንዴ መተግበሪያዎን ከፈጠሩ በኋላ የእርስዎን ያገኛሉ app_id እና app_secret

በዚህ ይግቡ

በዚህ በስርዓት መግባት ለሰዎች አካውንቶችን ለመፍጠር እና ወደ መተግበሪያዎ ለመግባት ፈጣን እና ምቹ መንገድ ነው ፡፡ በኛ ስርዓት መግባት ሁለት ሁኔታዎችን ያረጋግጣል፣ የሰዎችን ማንነትና እና የተጠቃሚዎችን መረጃ ለማግኘት ፍቃድ መጠየቅ ያስችላል ፡፡ በቀላሉ በኛ ስርዓት መግባት ማንነት ለማረጋገጥ ወይም ማንነትን ማረጋገጫ እና መረጃ ለማግኘት ያስችላል.

1. የ OAuth የመግቢያ ሂደቱን በመጀመር ላይ ፣ እንደዚህ ላለው መተግበሪያዎ አገናኝ መጠቀም ያስፈልግዎታል:

   <a href="https://www.ethiovisit.com/myplace/api/oauth?app_id=YOUR_APP_ID">Log in With ማይፕሌስ</a>

   ተጠቃሚው ወደ እንደዚህ ባለው ገጽ በመለያ እንዲገቡ ይመራል

   
2. ተጠቃሚው አንዴ መተግበሪያዎን ከተቀበለ በኋላ ፣ ተጠቃሚው ወደ የእርስዎ የመተግበሪያ ማስተላለፊያ ዩአርኤል ይመራል auth_key ልክ እንደዚህ:

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

   ይህ auth_key የሚሰራበት ለአንድ ጊዜ ብቻ ነው ፣ ስለሆነም አንዴ ከተጠቀሙበት በኋላ እንደገና ሊጠቀሙበት እና አዲስ ኮድ መፍጠር አይችሉም ፡፡ ተጠቃሚውን እንደገና ወደ አገናኝ ወደ ምዝግብ ማስታወሻ ማዞር ያስፈልግዎታል.

የመዳረሻ ምልክት

አንዴ የመተግበሪያዎን የተጠቃሚ ማረጋገጫ ካገኙ በኋላ በመስኮት ይግቡ እና ከ ‹ጋር› ተመለሱ auth_key ይህም ማለት አሁን ከኤ.ፒ.አይ.ዎችዎ መረጃን ለማግኘት ዝግጁ ነዎት እና ይህን ሂደት ለመጀመር ለመተግበሪያዎ ፈቃድ መስጠት እና ማግኘት ያስፈልግዎታል access_token እና እንዴት ማግኘት እንደሚችሉ ለማወቅ የእኛን እርምጃዎች መከተል ይችላሉ.

1. የመድረሻ ማስመሰያ ለማግኘት ፣ ለሚከተለው የመጨረሻ ነጥብ የ HTTP GET ጥያቄን ያቅርቡ:

   <?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://www.ethiovisit.com/myplace/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
       }
       ?>

   ይህ access_token የሚሰራው ለ 1 ሰዓት ብቻ ነው ፣ ስለሆነም ልክ ዋጋ ቢስ ከሆነ በኋላ እንደገና በአገናኝ ወደ ተጠቃሚው በመለያ በመግባት አዲስን ኮድ መፍጠር ማድረግ ያስፈልግዎታል.

ኤ.ፒ.አይ.ዎች

አንዴ የእርስዎን ካገኙ access_token የሚከተሉትን መለኪያዎች በሚደግፈው በ HTTP GET ጥያቄዎች አማካኝነት መረጃዎችን ከእኛ ስርዓት ማግኘት ይችላሉ

እንደዚህ ያለ የተጠቃሚ መረጃን ማግኘት ይችላሉ

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

ውጤቱ የሚሆነው:

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