ሰነድ

የኤፒአይ ስሪት 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
    
    // Prepare the POST data
    $postData = [
      'app_id' => $app_id,
      'app_secret' => $app_secret,
      'auth_key' => $auth_key
    ];
    
    // Initialize cURL
    $ch = curl_init('https://gojjochat.com/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
    }
    ?>
    
    ይህ access_token የሚሰራው ለአንድ ሰአት ብቻ ነው፡ አንዴ ልክ ያልሆነ ከሆነ ተጠቃሚውን እንደገና በማገናኘት አዲስ ማመንጨት ያስፈልግዎታል.
ኤፒአይዎች

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

የመጨረሻ ነጥብ መግለጫ
api/get_user_info

የተጠቃሚ መረጃ ያግኙ

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

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": ""
  }
}
Gojjochat https://gojjochat.com