Udviklere
Udforsk de udviklerværktøjer, vi tilbyder
API Version 1.1
Denne dokumentation forklarer, hvordan du registrerer, konfigurerer og udvikler din app, så du kan bruge vores API'er
Opret app
For at din app kan få adgang til vores API'er, skal du registrere din app ved hjælp af App Dashboard. Registrering opretter et app-id, der fortæller os, hvem du er, og hjælper os med at skelne din app fra andre apps.
- Du skal oprette en ny app Opret ny app
- Når du har oprettet din app, får du din app_id og app_secret
Log ind med
Log ind med systemet er en hurtig og bekvem måde for folk at oprette konti og logge ind på din app. Vores Log ind med-system muliggør to scenarier, godkendelse og at bede om tilladelser til at få adgang til folks data. Du kan bruge Login med-system blot til godkendelse eller til både godkendelse og dataadgang.
-
Start af OAuth-loginprocessen, du skal bruge et link til din app som dette:
<a href="https://zon.dk/api/oauth?app_id=YOUR_APP_ID">Log in With Zon.dk</a>
Brugeren vil blive omdirigeret til Log ind med side som denne
-
Når brugeren har godkendt din app, vil brugeren blive omdirigeret til din webadresse til omdirigering af apps med auth_key synes godt om dette:
https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY
Denne auth_key gælder kun for engangsbrug, så når du først har brugt det, vil du ikke være i stand til at bruge det igen og generere ny kode, du bliver nødt til at omdirigere brugeren til log ind med link igen.
Access Token
Når du har fået brugerens godkendelse af din app Log ind med vinduet Log ind med og returneret med auth_key hvilket betyder, at du nu er klar til at hente data fra vores API'er, og for at starte denne proces skal du godkende din app og få access_token og du kan følge vores trin for at lære, hvordan du får det.
-
Hvis du vil have et adgangstoken, skal du foretage en HTTP GET-anmodning til følgende slutpunkt på denne måde:
<?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://zon.dk/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 } ?>
Denne access_token gælder kun i en 1 time, når den blev ugyldig, skal du genarte en ny ved at omdirigere brugeren til login med link igen.
APIs
Når du har fået din access_token Nu kan du hente oplysninger fra vores system via HTTP GET-anmodninger, som understøtter følgende parametre
Slutpunkt | Beskrivelse |
---|---|
api/get_user_info |
Få brugeroplysninger |
Du kan hente brugeroplysninger på denne måde
if(!empty($json['access_token'])) { $access_token = $json['access_token']; // your access token $get = file_get_contents("https://zon.dk/api/get_user_info?access_token=$access_token"); }
Resultatet vil være:
{ "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": "" } }