Documentatie

API Version 1.1

In deze documentatie wordt uitgelegd hoe u uw app registreert, configureert en ontwikkelt, zodat u onze API's met succes kunt gebruiken

Creëer een App

Om uw app toegang te geven tot onze API's, moet u uw app registreren met de App Dashboard. Met uw registratie maakt een app-ID aan die ons laat weten wie je bent, zodat we je app kunnen onderscheiden van andere apps..

  1. Om te beginnen moet u een nieuwe app maken Creëer een nieuwe App
  2. Nadat u uw app hebt gemaakt, krijgt u uw app_id en uw app_secret
Login met:

Inloggen met ons systeem is een snelle en gemakkelijke manier voor mensen om accounts aan te maken en in te loggen met uw app. Ons inlog With-systeem maakt twee scenario's mogelijk, authenticatie en het vragen om toestemming om toegang te krijgen tot de gegevens van mensen. U kunt het Login With-systeem eenvoudig gebruiken voor authenticatie of voor zowel authenticatie als gegevenstoegang.

  1. Om het OAuth-inlogproces starten, moet u een link voor uw app op deze manier gebruiken:
    <a href="https://timeboek.nl/api/oauth?app_id=YOUR_APP_ID">Log in With TimeBoek</a>

    De gebruiker wordt omgeleid naar onderstaande scherm om in te loggen

  2. Zodra de gebruiker uw app heeft geaccepteerd, wordt de gebruiker doorgestuurd naar uw App Redirect URL met: auth_key zols dit:
    https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY
    Dit auth_key is alleen geldig voor eenmalig gebruik, dus als gebruiker het eenmaal heeft gebruikt, kan deze gebruiken het niet nog een keer kunnen gebruiken, hij zal dan een nieuwe code moeten genereren. Je moet de gebruiker opnieuw omleiden naar de login met een link..
Toegangstoken

Zodra u de gebruikersgoedkeuring van uw app heeft gekregen Log in met venster en keerde terug met de auth_key wat betekent dat u nu klaar bent om gegevens van onze API's op te halen en om dit proces te starten, u moet uw app autoriseren en de access_token en u kunt onze stappen volgen om uw app in te stellen..

  1. Om een ​​toegangstoken te krijgen, dient u een HTTP GET-verzoek naar het volgende eindpunt als volgt te doen::
                <?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
    
                $get = file_get_contents("https://timeboek.nl/api/authorize?app_id=$app_id&app_secret=$app_secret&auth_key=$auth_key");
    
                $json = json_decode($get, true);
                if(!empty($json['access_token'])) {
                    $access_token = $json['access_token']; // your access token
                }
                ?>                                                                                                
                                
    Dit access_token is slechts één uur geldig, dus zodra deze ongeldig is geworden, moet u een nieuwe aanmaken door de gebruiker opnieuw om te leiden naar de login met link..
APIs

Zodra u uw access_token heeft kunt u informatie van ons systeem ophalen via HTTP GET-verzoeken die de volgende parameters ondersteunen:

Endpoint Beschrijving
api/get_user_info

gebruikersinformatie ophalen

U kunt gebruikersinformatie op deze manier ophalen

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

De volgende gegevens worden opgehaald::

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