Bienvenue sur l'API Galileo !

Dernière mise à jour: 19/01/2019

Présentation

Bienvenue sur le service d'authentification aux API Galileo. Cette documentation vous renseignera sur la génération de token pour la connexion à vos applications API Galileo.

Utilisation

1. Création d'un compte développeur Galileo

Afin d'accèder à l'API Galileo, vous devez posséder au préalable un compte développeur Galileo. Pour cela, rapprochez-vous du bureau de l'année courante. Un compte développeur Galileo est composé essentiellement de :

  • GUID : Identifiant unique développeur Galileo à 42 caractères, au format GUxxx
  • Key : Clé de sécurité associée à votre compte à 64 caractères

2. Génération d'un token unique

Générez un token unique afin d'accèder à une application spécifique de l'API Galileo, grâce à votre GUID et votre clé. Effectuez pour cela une requête GET de ce type :

GET https://api.galileo-cpe.net/?app=GALIBOT&guid=GUa1b2&key=c3d4

Paramètres :

  • app : APP CODE de l'application pour laquelle vous souhaitez générer le token (voir la liste des applications compatibles)
  • guid : Votre identifiant unique développeur Galileo à 42 caractères
  • key : Votre clé de sécurité associée à votre compte à 64 caractères

Exemple de résultat (JSON) :

{
    "result": "ok",
    "app": "GaliBot SMS",
    "token": "GTz1y2x3",
    "expire": 1547898898
}

  • app : Nom complet de l'application concernée
  • token : Token généré à 84 caractères, au format GTxxx, pour fournir à l'application concernée
  • expire : Timestamp en secondes d'expiration du token

3. Utilisation du token sur les API Galileo

Une fois le token GTxxx généré, utilisez-le pour vous authentifier à l'application concernée grâce à la documentation spécifique pour chacune.

Applications compatibles

Afin d'accèder à l'API Galileo, vous devez posséder au préalable un compte développeur Galileo. Pour cela, rapprochez-vous du bureau de l'année courante. Un compte développeur Galileo est composé essentiellement d'un couple UID / Key.

APP CODE Name DTV* Endpoint
GALIBOT GaliBot - Envoi de SMS 2h https://api.galileo-cpe.net/galibot/
GALIPORTE Gestion de la GaliPorte 2h https://api.galileo-cpe.net/galiporte/

*DTV : "Default Token Validity", validité par défaut des tokens générés pour cette application.

Vérification de tokens (pour Apps)


Rubrique destinée aux développeurs d'API Galileo.
Vous pouvez vérifier la validité d'un token et obtenir le GUID de vos utilisateurs. Effectuez pour cela une requête GET de ce type :

GET https://api.galileo-cpe.net/app?app=a1b2c3&token=GTz1y2x3

Paramètres :

  • app : Clé de l'application pour laquelle vous souhaitez vérifier le token
  • token : Token à vérifier de 84 caractères, au format GTxxx

Exemple de résultat OK (JSON) :

{
    "result": "ok",
    "user": {
        "guid": "GUa1b2",
        "first_name": "John",
        "last_name": "Doe"
    },
    "expire": 1547898898,
    "flags": ""
}

  • user : Informations sur l'utilisateur (GUID, prénom et nom)
  • expire : Timestamp en secondes d'expiration du token

Exemple de résultat Echec (JSON) :

{
    "result": "error",
    "comment": "Invalid or expired token."
}

Exemples de codes - Obtention de token

Retrouvez ci-dessous des exemples de codes en différents langages pour obtenir un token sur l'API Galileo.

PHP Code Example
$app = "GALIBOT";

$GUID = "GUa1b2";
$key = "c3d4";

$GALILEO_API_ENDPOINT = "https://api.galileo-cpe.net";
$rsp = json_decode(file_get_contents($GALILEO_API_ENDPOINT."/?app=".urlencode($app)."&guid=".urlencode($GUID)."&key=".urlencode($key)), true);

if($rsp["result"] != "ok")
    echo "API Error : ".$rsp["comment"];
else
    echo "Token: ".$rsp["token"];
NodeJS Code Example
var request = require("request");

let APP_CODE = "GALIBOT";
let GUID = "GUa1b2";
let key = "c3d4";

request("https://api.galileo-cpe.net/?app=" + APP_CODE + "&guid=" + GUID + "&key=" + key, function (error, response, body) {
    let rsp = JSON.parse(body);
    if(rsp.result != "ok")
        console.log("API Error : " + rsp.comment);
    else
        console.log("Token : " + rsp.token);
});

Exemples de codes - Vérification de token (pour Apps)

Retrouvez ci-dessous des exemples de codes en différents langages pour obtenir un token sur l'API Galileo.

PHP Code Example
$app_key = "a1b2c3";
$token = "GTz1y2x3";

$GALILEO_API_ENDPOINT = "https://api.galileo-cpe.net/app";
$rsp = json_decode(file_get_contents($GALILEO_API_ENDPOINT."/?app=".urlencode($app_key)."&token=".urlencode($token)), true);

if($rsp["result"] != "ok")
    echo "API Error : ".$rsp["comment"];
else
    echo "User GUID: ".$rsp["user"]["guid"];
NodeJS Code Example
var request = require("request");

let APP_KEY = "a1b2c3";
let token = "GTz1y2x3";

request("https://api.galileo-cpe.net/app/?app=" + APP_KEY + "&token=" + token, function (error, response, body) {
    let rsp = JSON.parse(body);
    if(rsp.result != "ok")
        console.log("Invalid Token!");
    else
        console.log("Welcome " + rsp.user.guid);
});