Utilisation de la documentation intégrée à l'application

GTF intégre une documentation API intéractive.

Ce qui vous permet d'utiliser les requêtes directement via la documentation.

Doc Swagger

Chaque routes décrites est précédées d'une description qui vous donnera les pré-requis (s'il y en a).

Doc Swagger

Format génériques des réponses

{
   "data" : [],
   "status" : 1
}

La clé data pourra référencé un tableau d'objet ou objet (en fonction du type de requête).

la clé status prendra comme valeur 0 ou 1 (1 tout se passe bien, 0 il y a une erreur avec les paramètres).

Utilisation des filtres JSON

Tous les filtres json de l'application ont la même structure.

Ils peuvent être imbriqués récursivement (une structure relation/opérateurs est aussi un opérateur).

{
   "relation" : "AND",
   "operators" : [{
      "column" : "champ1",
      "compare_operator" : "LIKE",
      "value" : "%Ma_valeur%",
      "compare_operator_options": {
         "case_insensitive":true
         }
   },
   {
      "column":"champ2",
      "compare_operator":"=",
      "value":"val_2"}]
}

La clé relation peut prendre une des valeurs suivante :

  • OR

  • AND

Les opérateurs ont une structure plus ou moins dynamiques, au minimum on retrouvera trois champs column, comapre_operator, value, puis en fonction de l'opérateur il pourra y avoir des informations complémentaires (le plus souvent non obligatoire).

Les opérateurs de comparaison acceptés par l'application sont :

  • LIKE

  • =

  • < et <=

  • > et >=

  • IN