1

Consultez vos disponibilités

availability

GET https://cronorg.com/api/v1/availability?login=&password=

loginVotre code d'identification.
passwordVotre mot de passe.
startdateDate de début.
enddateDate de fin.

startdate - YYYY-MM-DD, e.g. 2023-01-01. enddate - YYYY-MM-DD, e.g. 2023-12-31.

NOTE : Les paramètres startdate et enddate sont obligatoires.

$ curl -D - -X GET "https://cronorg.com/api/v1/availability?login=abcdef&password=ABCDEF&startdate=2023-01-01&enddate=2023-12-31"
{"status":"success","data":{"total_hours":56,"total_days":8,"weeks":{"3":12,"4":28,"5":16},"timeline":[8,4,0,0,8,8,0,8,4,0,0,8,8]}}

Retourne vos disponibilités du jeudi 19 janvier 2023 au mardi 31 janvier 2023 avec 8 heures de disponibles du lundi au jeudi et 4 heures le vendredi et un jour d'absence le mercredi 25 janvier 2023.

Cliquez sur l'horloge dans la barre de menu de votre page d'accueil personnelle pour éditer vos disponibilités.

Téléchargez le code de la fonction sendget définie dans le fichier sendhttp.php. Copiez le fichier dans l'espace de votre application.

sendhttp.php

NOTE : Reportez-vous à la page Appelez l'API du service pour une description de la fonction sendget.

Ajoutez le fichier availability.php avec le contenu suivant :

availability.php
  1. require_once 'sendhttp.php';

Charge le code de la fonction sendget fournie par iZend.

  1. function availability($login, $password, $startdate, $enddate) {

Définit la fonction availability. $login est votre code d'identification. $password est votre mot de passe. $startdate spécifie le début de la période, $enddate la fin de la période. $startdate et $enddate sont des entiers du type horodatage (Unix timestamp).

  1.     $curl = 'https://cronorg.com/api/v1/availability';

Met $curl à l'URL de l'action availability.

  1.     $args = array(
  2.         'login'     => $login,
  3.         'password'  => $password,
  4.         'startdate' => date('Y-m-d', $startdate),
  5.         'enddate'   => date('Y-m-d', $enddate),
  6.     );

Prépare la liste des arguments du GET : le code d'identification et le mot de passe du compte de l'utilisateur, la date de début et de fin de la période.

  1.     $response=sendget($curl, $args);

Envoie la requête HTTP avec sendget.

  1.     if (!$response or $response[0] != 200) {
  2.         return false;
  3.     }

Si $response vaut false, le serveur est inaccessible. Si $response[0] ne contient pas le code de retour HTTP 200 Ok, une erreur d'exécution s'est produite. En cas d'erreur, availability retourne false.

  1.     $r=json_decode($response[2], true);

Décode les données retournées en JSON.

  1.     if ($r['status'] == 'success') {
  2.         return ($r['data']);
  3.     }

Retourne le tableau des données si l'action a réussi.

  1.     return false;
  2. }

Retourne false en cas d'erreur.

EXEMPLE

En supposant que vous avez sauvé les fichiers sendhttp.php et availability.php dans le répertoire courant, lancez PHP en mode interactif, chargez la fonction availability et appelez-la avec en arguments votre code d'identification et votre mot de passe, une date de début et de fin de période :

$ php -a
php > require_once 'availability.php';
php > print_r(availability('abcdef', 'ABCDEF', strtotime('2023-01-19'), strtotime('2023-01-31')));
Array
(
    [total_hours] => 56
    [total_days] => 8
    [weeks] => Array
        (
            [3] => 12
            [4] => 28
            [5] => 16
        )

    [timeline] => Array
        (
            [0] => 8
            [1] => 4
            [2] => 0
            [3] => 0
            [4] => 8
            [5] => 8
            [6] => 0
            [7] => 8
            [8] => 4
            [9] => 0
            [10] => 0
            [11] => 8
            [12] => 8
        )
)
php > quit
VOIR AUSSI

Appelez l'API du service

Commentaires

Pour ajouter un commentaire, cliquez ici.