የኤፒአይ ስሪት 1.1

ይህ ሰነድ መተግበሪያዎን በተሳካ ሁኔታ እንዴት እንደሚመዘገቡ፣ እንደሚያዋቅሩ እና እንደሚያዳብሩ ያብራራል።

መተግበሪያ ፍጠር

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

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

በ ጋር ይግቡ

በስርዓት ግባ ሰዎች መለያ ለመፍጠር እና ወደ መተግበሪያዎ ለመግባት ፈጣን እና ምቹ መንገድ ነው። የኛ ሎግ መግቢያ በስርዓት ሁለት ሁኔታዎችን፣ ማረጋገጥ እና የሰዎችን ውሂብ ለመድረስ ፍቃድ መጠየቅን ያስችላል። በቀላሉ ለማረጋገጫ ወይም ሁለቱንም ለማረጋገጥ እና ለመረጃ መዳረሻ Login With ሲስተም መጠቀም ይችላሉ።.

1. የOAuth የመግባት ሂደትን በመጀመር፣ ለእንደዚህ አይነት መተግበሪያዎ አገናኝ መጠቀም አለብዎት:

   <a href="https://gojjochat.com/api/oauth?app_id=YOUR_APP_ID">Log in With Gojjochat</a>

   ተጠቃሚው እንደዚህ ባለው ገጽ ወደ Log in ይመራሉ።

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

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

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

የመዳረሻ ማስመሰያ

አንዴ የተጠቃሚውን ፈቃድ ካገኙ የመተግበሪያዎን ሎግ ኢን ጋር በመስኮት ይግቡ እና በ auth_key ይህ ማለት አሁን ከኤፒአይዎቻችን ውሂብ ለማውጣት ዝግጁ ነዎት እና ይህን ሂደት ለመጀመር መተግበሪያዎን መፍቀድ እና ማግኘት ያስፈልግዎታል access_token እና እንዴት ማግኘት እንደሚችሉ ለማወቅ የእኛን ደረጃዎች መከተል ይችላሉ.

1. የመዳረሻ ማስመሰያ ለማግኘት፣ በሚከተለው የመጨረሻ ነጥብ ላይ የኤችቲቲፒ 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://gojjochat.com/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 የሚሰራው ለአንድ ሰአት ብቻ ነው፡ አንዴ ልክ ያልሆነ ከሆነ ተጠቃሚውን እንደገና በማገናኘት አዲስ ማመንጨት ያስፈልግዎታል.

ኤፒአይዎች

አንዴ ካገኘህ access_token አሁን የሚከተሉትን መመዘኛዎች በሚደግፉ በ HTTP GET ጥያቄዎች በኩል ከስርዓታችን መረጃ ማግኘት ይችላሉ።

እንደዚህ አይነት የተጠቃሚ መረጃ ሰርስሮ ማውጣት ትችላለህ

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