Le projet CommoPrices API a été lancé lors du Sandwich Class Camp 2 à l'ETNA par l'entreprise CommoPrices.
Celui-ci à pour but de générer un fichier au format JSON contenant les informations des marchés des matières premières et autres.
Remplacer les fichiers par ceux du Git (dossier) et lancer Laravel (php artisan serve
).
Si vous souhaitez rajouter d'autres choses :
- Middleware :
php artisan make:middleware {name}
- Controlleur :
php artisan make:controller {name}
- Migration SQL :
php artisan make:migration {name}
Dans le <head>
de la view graph ajouter :
<link rel="stylesheet" href="/assets/css/style.css" type="text/css">
<script src="/assets/js/amcharts/amcharts.js" type="text/javascript"></script>
<script src="/assets/js/amcharts/serial.js" type="text/javascript"></script>
<script src="/assets/js/amcharts/themes/dark.js" type="text/javascript"></script>
<script src="/assets/js/jquery.min.js"></script>
<script src="/assets/js/graph.js"></script>
Pour accéder à l'API, vous devez être obligatoirement authentifié, voici la méthode :
http://localhost:8000/api/auth/{user}/{token}
Après avoir fait toutes vos demandes vous pouvez fermer votre session :
http://localhost:8000/api/logout
Avec cette méthode vous pouvez afficher les données et filtrer via differents paramètres :
- flux (GET, accessible NC8) : i (import) ou e (export),
- country (GET, accessible NC8) : code ISO 3166-1,
- start & end (GET, accessible NC8 & IMF) : date de début et de fin (il n'est pas obligatoire d'utiliser les deux en même temps) au format M-YYYY,
- lang (GET, accessible NC8 & IMF) : afficher les données dans la langue de votre choix.
Exemple : http://localhost:8000/api/show/nc8_18010000?flux=e&country=it&start=1-2014&end=3-2015&lang=fr
Cette méthode permet d'afficher seulement la variation en pourcent d'une matière dans un interval.
Tous les paramètres peuvent être utilise sauf start & end.
Un nouveau paramètre est disponible pour la variation :
- inter (GET, accessible NC8 & IMF) : mensuel, trimestriel ou semestriel (m, t ou s) par défaut mensuel,
Pour le paramètre flux si l'on ne précise pas le sens, l'export sortira par defaut.
Exemple : http://localhost:8000/api/var/nc8_18010000?country=it&start=1-2014&end=3-2015&lang=fr
Vous pouvez afficher un graphique avec les données de l'API.
Exemple : http://localhost:8000/graph/{matiere}
Vous devez inscrire l'utilisateur et le token de l'utilisateur dans graph.js
.
var log = "{user}";
token = "{token}";
res = 0;
prix_max = 0;
prix_min = 9999999999;
theme = "dark";
API CommoPrices © 2015, PERRIER Aurélien, MARTINELLI Sébastien & LEON Vincent
Released under the MIT License.
GitHub @perriea · GitHub @cenevol · GitHub @Vincent--L