Προγραμματιστές
Εξερεύνησε τα εργαλεία προγραμματιστών που προσφέρουμε
Αυτή η τεκμηρίωση εξηγεί πώς να καταχωρίσεις, να ρυθμίσεις και να αναπτύξεις την εφαρμογή σου, ώστε να χρησιμοποιείς με επιτυχία τα API μας
Έκδοση API 1.1Δημιουργία εφαρμογής
Για να έχει πρόσβαση η εφαρμογή σου στα API μας, πρέπει να την καταχωρίσεις μέσω του Πίνακα εφαρμογών. Με την καταχώριση δημιουργείται ένα ID εφαρμογής, που μας δείχνει ποιος είσαι και μας βοηθά να ξεχωρίζουμε την εφαρμογή σου από τις άλλες.
-
1
Θα χρειαστεί να δημιουργήσεις μια νέα εφαρμογή Δημιουργία νέας εφαρμογής
-
2
Μόλις δημιουργήσεις την εφαρμογή σου, θα λάβεις τα
app_idκαιapp_secret
Σύνδεση με
Το σύστημα «Σύνδεση με» είναι ένας γρήγορος και βολικός τρόπος για να δημιουργούν οι χρήστες λογαριασμούς και να συνδέονται στην εφαρμογή σου. Υποστηρίζει δύο σενάρια: τον έλεγχο ταυτότητας και το αίτημα άδειας πρόσβασης στα δεδομένα των χρηστών. Μπορείς να το χρησιμοποιήσεις μόνο για έλεγχο ταυτότητας ή και για έλεγχο ταυτότητας και για πρόσβαση σε δεδομένα.
-
1
Για να ξεκινήσεις τη διαδικασία σύνδεσης OAuth, χρησιμοποίησε έναν σύνδεσμο για την εφαρμογή σου όπως αυτός:
Ο χρήστης θα μεταφερθεί σε μια σελίδα «Σύνδεση με» όπως αυτήHTML
<a href="https://siblia.com/api/oauth?app_id=YOUR_APP_ID">Log in With Siblia</a>
-
2
Μόλις ο χρήστης αποδεχτεί την εφαρμογή σου, θα μεταφερθεί στο URL ανακατεύθυνσης της εφαρμογής σου με το
auth_keyως εξής:URLhttps://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEYΑυτό τοauth_keyισχύει για μία μόνο χρήση. Αφού το χρησιμοποιήσεις, δεν μπορείς να το ξαναχρησιμοποιήσεις, και για να πάρεις νέο κωδικό πρέπει να μεταφέρεις ξανά τον χρήστη στον σύνδεσμο «Σύνδεση με».
Token πρόσβασης
Μόλις ο χρήστης εγκρίνει την εφαρμογή σου στο παράθυρο «Σύνδεση με» και επιστρέψει με το auth_key μπορείς πλέον να λαμβάνεις δεδομένα από τα API μας. Για να ξεκινήσεις, πρέπει να εξουσιοδοτήσεις την εφαρμογή σου και να λάβεις το access_token και μπορείς να ακολουθήσεις τα βήματά μας για να μάθεις πώς να το λάβεις.
<?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://siblia.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, που υποστηρίζουν τις παρακάτω παραμέτρους
/api/get_user_info
λήψη στοιχείων χρήστη
if (!empty($json['access_token'])) {
$access_token = $json['access_token']; // your access token
$get = file_get_contents("https://siblia.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": ""
}
}