Προγραμματιστές

Εξερεύνησε τα εργαλεία προγραμματιστών που προσφέρουμε

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

Έκδοση API 1.1

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

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

  1. 1
    Θα χρειαστεί να δημιουργήσεις μια νέα εφαρμογή Δημιουργία νέας εφαρμογής
  2. 2
    Μόλις δημιουργήσεις την εφαρμογή σου, θα λάβεις τα app_id και app_secret

Σύνδεση με

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

  1. 1 Για να ξεκινήσεις τη διαδικασία σύνδεσης OAuth, χρησιμοποίησε έναν σύνδεσμο για την εφαρμογή σου όπως αυτός:
    HTML
    <a href="https://www.flexartsocial.com/api/oauth?app_id=YOUR_APP_ID">Log in With flexartsocial.com</a>
    Ο χρήστης θα μεταφερθεί σε μια σελίδα «Σύνδεση με» όπως αυτή
  2. 2 Μόλις ο χρήστης αποδεχτεί την εφαρμογή σου, θα μεταφερθεί στο URL ανακατεύθυνσης της εφαρμογής σου με το auth_key ως εξής:
    URL
    https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY
    Αυτό το auth_key ισχύει για μία μόνο χρήση. Αφού το χρησιμοποιήσεις, δεν μπορείς να το ξαναχρησιμοποιήσεις, και για να πάρεις νέο κωδικό πρέπει να μεταφέρεις ξανά τον χρήστη στον σύνδεσμο «Σύνδεση με».

Token πρόσβασης

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

Για να λάβεις ένα token πρόσβασης, κάνε ένα αίτημα HTTP GET στο παρακάτω endpoint ως εξής:
PHP
<?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://www.flexartsocial.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));
}

// 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 ώρα. Όταν λήξει, θα πρέπει να δημιουργήσεις νέο, μεταφέροντας ξανά τον χρήστη στον σύνδεσμο «Σύνδεση με».

API

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

GET /api/get_user_info λήψη στοιχείων χρήστη
Μπορείς να λάβεις τα στοιχεία του χρήστη ως εξής
PHP
if (!empty($json['access_token'])) {
  $access_token = $json['access_token']; // your access token
  $get = file_get_contents("https://www.flexartsocial.com/api/get_user_info?access_token=$access_token");
}
Το αποτέλεσμα θα είναι:
JSON
{
  "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": ""
  }
}