Toleo la API 1.1

Hati hii inaelezea jinsi ya kusajili, kusanidi, na kukuza programu yako ili uweze kutumia APIs zetu kwa mafanikio

Tengeneza Program

Ili programu yako ifikie APIs zetu, lazima uandikishe programu yako kwa kutumia Dashibodi ya Programu. Usajili huunda Kitambulisho cha Programu ambacho kinatujulisha wewe ni nani, hutusaidia kutofautisha programu yako na programu zingine.

1. Utahitaji kuunda program mpya Tengeneza Programu Mpya
2. Mara tu ukiunda App yako utapata app_id na app_secret

Ingia Kwa Kutumia

Kuingia na mfumo ni njia ya haraka na rahisi kwa watu kuunda akaunti ili waiingie kwenye programu yako. Mfumo wetu wa kuingia unawezesha matukio mawili,uthibitishaji na kuomba ruhusa ya kufikia data za watu. Unaweza kutumiaMfumo wa kuingia kwa uthibitisho tu au kwa uthibitishaji na data.

1. Kuanzisha mchakato wa kuingia kwa OAuth, Unahitaji kutumia kiungo cha programu yako kama hii:

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

   Mtumiaji ataelekezwa kuingia na ukurasa kama huu

   
2. Mara tu mtumiaji anapokubali programu yako, mtumiaji ataelekezwa kwenye App yako Elekeza URL na auth_key kama hii:

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

   Hii auth_key halali tu kwa matumizi ya wakati mmoja, kwa hivyo ukishatumia hautaweza kutumia tena na utengeneze nambari mpya utahitaji kuelekeza mtumiaji kuingiana kiungo tena".

Nambari Ya Ufikiaji

Mara tu unapopata idhini ya mtumiaji wa programu yako Ingia na urudi na auth_key ambayo inamaanisha kuwa sasa uko tayari kupata data kutoka kwa API zetu na kuanza mchakato huu utahitaji kuidhinisha programu yako na kupata faili ya access_token na unaweza kufuata hatua zetu ili ujifunze jinsi ya kuipata.

1. Ili kupata ishara ya ufikiaji, fanya ombi la kupata HTTP kwa mwisho ifuatayo kama hii:

   <?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://proshabo.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
   }
   ?>
   

   Hii access_token halali kwa saa moja tu, kwa hivyo ikishakuwa batili utahitaji kuanzisha mpya kwa kuelekeza mtumiaji kuingia na kiunga tena.

APIs

Mara tu unapopata access_token Sasa unaweza kupata habari kutoka kwa mfumo wetu kupitia maombi ya HTTP GET ambayo inasaidia vigezo vifuatavyo

Unaweza kupata maelezo ya mtumiaji kama hivi

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

Matokeo yatakuwa:

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