Datapi

Contraction de Data et Api.

L'idée est de limité les requêtes API afin d'être respectueux des services API disponible.

Le concept

Je veux récupérer la dernière release, je contact l'api disponible.

Sauf qu'ici on utilise un script qui automatise les proccess. Si pour x raison, tests, debug, le script peut être relancer X fois. J'ai pas spécialement envie de contacter l'api x fois, si j'ai déjà récupérer l'info. souhaitée.

Je vais donc enregistrer cette information dans un fichier (ici json), et je contacterai l'api que si je ne dispose pas de l'info. où si je considère que l'info. dont je dispose n'est pas assez récente.

En fonction du besoin cette date de 'validité' peut varier, par exemple pour PostFixAdmin, les releases ne sont pas quotidienne inutile d'aller demander l'information tous les jours.

implémentation

#datapi - connaître la dernière version disponible
$datapi=new Datapi('postfixadmin');
    # est-ce que l'information est encore valable?
    if($datapi->need_refresh()){
        # on contact l'api

        $o=new \stdClass();

        # propriétés nécessaire à Datapi
        $o->url=$url;
        $o->expiration='one-week';

        # on sauvegarde l'information
        $datapi->save($o);
        $data=$o;
    }else $data=$datapi->get_data(); # on récupère l'info locale

    # on a l'info. sur la dernière release on peut continuer

    ...