Guhertoya API'yê 1.1

Ev belgekirin rave dike ka meriv çawa serlêdana xwe tomar dike, mîheng dike û pêşve dibe da ku tu bi serfirazî API'yên me bikar bînî

Serlêdanê Çêke

Ji bo ku serlêdana te bigihîje API'yên me, divê tu serlêdana xwe bi karanîna Dashboarda Serlêdanê. Tomarkirin Nasnameyek Serlêdanê çêdike ku dihêle em bizanibin tu kî yî, ji me re dibe alîkar ku em serlêdana te ji serlêdanên din cuda bikin.

1. Pêdivî ye ku tu Serlêdanek nû çê bikî Serlêdanek Nû Biafirîne
2. Gava te Serlêdana xwe çêkir, dê tu bistînî app_id û app_secret

Têkeve Bi

Pergala Têketinê (Log in With) rêyek bilez û hêsan e ji bo mirovan ku hesabên xwe çêbikin û têkevin serlêdana te. Pergala me ya Têketinê du senaryoyan çalak dike, nasandin (authentication) û xwestina destûrên gihîştina daneyên mirovan. Tu dikarî Pergala Têketinê tenê ji bo nasandinê an ji bo hem nasandin û hem jî gihîştina daneyan bikar bînî.

1. Pêvajoya têketina OAuth dest pê dike, Pêdivî ye ku tu ji bo serlêdana xwe girêdanek mîna vê bikar bînî:

   <a href="https://kurdstad.com/api/oauth?app_id=YOUR_APP_ID">Log in With Kurd Stad | Cihê Têkiliyê ya Gelê Kurd</a>

   Bikarhêner dê ber bi rûpela Têketinê ya mîna vê ve were rêvebirin

   
2. Gava bikarhêner serlêdana te qebûl kir, dê bikarhêner ber bi URL'ya Rêvekirinê ya Serlêdana Te ve bi auth_key mîna vê:

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

   Ev auth_key tenê ji bo yek carî bikaranînê derbasdar e, ji ber vê yekê gava tu bikar bînî dê tu nikaribî wê dîsa bikar bînî û ji bo çêkirina kodê nû divê tu bikarhêner ji nû ve bişînî girêdana têketinê.

Tokena Gihîştinê

Gava tu pejirandina bikarhênerê ji pencereya Têketinê ya serlêdana xwe bistînî û bi auth_key ku tê vê wateyê ku tu niha amade yî ku daneyan ji API'yên me bistînî û ji bo destpêkirina vê pêvajoyê divê tu serlêdana xwe destûrdar bikî û get the access_token û tu dikarî gavên me bişopînî da ku hîn bibî ka meriv çawa wê distîne.

1. Ji bo bidestxistina nîşaneyek gihîştinê (access token), daxwazek HTTP GET'ê bişîne vê xala dawî (endpoint) ya mîna vê:

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

   Ev access_token tenê ji bo 1 saetê derbasdar e, ji ber vê yekê gava ew bêbandor bibe dê tu neçar bimînî ku yek nû çê bikî bi şandina bikarhêner ber bi girêdana têketinê ve dîsa.

APIs

Gava tu bistînî access_token Niha tu dikarî agahdariyan ji pergala me bi rêya daxwazên HTTP GET'ê yên ku piştgirî didin van pîvanan bistînî

Tu dikarî agahdariya bikarhêner bi vî awayî bistînî

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

Encam dê ev be:

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