Handbækur

API útgáfa 1.1

Þessi skjöl útskýra hvernig á að skrá, stilla og þróa forritið þitt svo þú getir notað API-viðmótin okkar með góðum árangri.

Búa til forrit

Til þess að appið þitt geti fengið aðgang að API-um okkar verður þú að skrá appið þitt með því að nota Mælaborð forrits. Skráning býr til forritsauðkenni sem lætur okkur vita hver þú ert og hjálpar okkur að greina forritið þitt frá öðrum forritum..

  1. Þú þarft að búa til nýtt forrit Búa til nýtt forrit
  2. Þegar þú hefur búið til appið þitt færðu þitt app_id og app_secret
Innskráning með

Innskráningarkerfið er fljótleg og þægileg leið fyrir fólk til að stofna reikninga og skrá sig inn í appið þitt. Innskráningarkerfið okkar býður upp á tvær aðferðir, auðkenningu og að biðja um leyfi til að fá aðgang að gögnum fólks. Þú getur notað Innskráningarkerfið einfaldlega fyrir auðkenningu eða bæði fyrir auðkenningu og aðgang að gögnum..

  1. Þegar þú byrjar innskráningarferlið fyrir OAuth þarftu að nota tengil fyrir forritið þitt eins og þennan.:
    <a href="https://wiply.net/api/oauth?app_id=YOUR_APP_ID">Log in With Wiply</a>

    Notandinn verður vísaður á síðuna Innskráning með svona

  2. Once the user accepted your app, the user will be redirected to your App Redirect URL with auth_key svona:
    https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY
    Þetta auth_key Gildir aðeins einu sinni, svo eftir að þú hefur notað það geturðu ekki notað það aftur og búið til nýjan kóða. Þú þarft að beina notandanum aftur á innskráningarsíðuna með tenglinum..
Aðgangslykill

Þegar þú hefur fengið samþykki notandans fyrir forritinu þínu birtist glugginn Innskráning með og kemur til baka með auth_key sem þýðir að nú ertu tilbúinn/in að sækja gögn úr forritaskilum okkar og til að hefja þetta ferli þarftu að heimila forritið þitt og fá access_token og þú getur fylgt skrefunum okkar til að læra hvernig á að fá það.

  1. Til að fá aðgangslykil skaltu senda HTTP GET beiðni til eftirfarandi endapunkts svona:
    <?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://wiply.net/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
    }
    ?>
    
    Þetta access_token Gildir aðeins í eina klukkustund, svo þegar það verður ógilt þarftu að búa til nýtt með því að beina notandanum aftur á innskráningarsíðuna með tenglinum..
API-viðmót

Þegar þú færð þitt access_token Nú er hægt að sækja upplýsingar úr kerfinu okkar með HTTP GET beiðnum sem styðja eftirfarandi breytur

Endapunktur Lýsing
api/get_user_info fá upplýsingar um notanda

Þú getur sótt upplýsingar um notanda svona

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

Niðurstaðan verður:

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