Έκδοση API 1.1

Αυτή η τεκμηρίωση εξηγεί πώς να εγγράψεις, ρυθμίσεις και αναπτύξεις την εφαρμογή σου για να χρησιμοποιείς τα APIs μας

Δημιουργία εφαρμογής

Για να έχει η εφαρμογή σου πρόσβαση στα APIs, πρέπει να την εγγράψεις μέσω του Πίνακας εφαρμογών. Η εγγραφή δημιουργεί App ID ώστε να ξέρουμε ποιος είσαι και να ξεχωρίζουμε την εφαρμογή σου.

1. Θα χρειαστεί να δημιουργήσεις νέα εφαρμογή Δημιουργία νέας εφαρμογής
2. Αφού δημιουργήσεις την εφαρμογή θα πάρεις το app_id και app_secret

Σύνδεση με

Το σύστημα «Σύνδεση με» είναι ένας γρήγορος τρόπος δημιουργίας λογαριασμού και σύνδεσης στην εφαρμογή σου. Υποστηρίζει δύο σενάρια: ταυτοποίηση και αίτημα δικαιωμάτων πρόσβασης σε δεδομένα. Μπορείς να το χρησιμοποιήσεις μόνο για ταυτοποίηση ή και για τα δύο.

1. Για να ξεκινήσεις τη σύνδεση OAuth, χρησιμοποίησε έναν σύνδεσμο εφαρμογής όπως αυτός:

   <a href="https://sngine-app.fluttercrafters.com/api/oauth?app_id=YOUR_APP_ID">Log in With Sngine Flutter Crafters</a>

   Ο χρήστης θα ανακατευθυνθεί στη σελίδα «Σύνδεση με» όπως αυτή

   
2. Αφού ο χρήστης αποδεχτεί την εφαρμογή σου, θα ανακατευθυνθεί στο URL ανακατεύθυνσης με auth_key όπως αυτό:

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

   Αυτό auth_key ισχύει μόνο μία φορά· αφού το χρησιμοποιήσεις, για νέο κωδικό πρέπει να ανακατευθύνεις ξανά τον χρήστη στον σύνδεσμο σύνδεσης.

Access Token

Αφού πάρεις την έγκριση του χρήστη στο παράθυρο «Σύνδεση με» και επιστρέψεις με το auth_key που σημαίνει ότι είσαι έτοιμος να λάβεις δεδομένα από τα APIs μας· για να ξεκινήσεις πρέπει να εξουσιοδοτήσεις την εφαρμογή και να πάρεις το access_token και μπορείς να ακολουθήσεις τα βήματά μας για να το πάρεις.

1. Για access token, κάνε HTTP GET στο παρακάτω endpoint όπως αυτό:

           <?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://sngine-app.fluttercrafters.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 ισχύει μόνο για 1 ώρα· όταν λήξει, δημιούργησε νέο ανακατευθύνοντας τον χρήστη ξανά στον σύνδεσμο σύνδεσης.

APIs

Αφού πάρεις το access_token Τώρα μπορείς να λαμβάνεις πληροφορίες μέσω HTTP GET με τις παρακάτω παραμέτρους

Μπορείς να λάβεις στοιχεία χρήστη ως εξής

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