Exemple de création ou modification de ligne dans une table
{
"info": {
"_postman_id": "2b518691-8359-4790-97cd-69c3040e1b7a",
"name": "Support ttc-api",
"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
},
"item": [
{
"name": "createOrUpdateTableRow example",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"value": "application/x-www-form-urlencoded",
"type": "text"
}
],
"body": {
"mode": "urlencoded",
"urlencoded": [
{
"key": "req",
"value": "createOrUpdateTableRow",
"description": "nom de la requête",
"type": "text"
},
{
"key": "version",
"value": "6.49n",
"description": "version target de l'api",
"type": "text"
},
{
"key": "u_c",
"value": "",
"description": "code user corresondant à la sesskey",
"type": "text"
},
{
"key": "o_u",
"value": "",
"description": "code user corresondant à la sesskey, sert dans certains cas ou l'on veut écrire au nom d'un autre utilisateur (cas non couvert par cet exemple)",
"type": "text"
},
{
"key": "sesskey",
"value": "",
"description": "clé de session récupérée depuis le profil utilisateur",
"type": "text"
},
{
"key": "rowId",
"value": "12345678",
"description": "id de la ligne visée par la modification, tmp suivi d'un uuid virtuel pour indiquer une création de ligne (i.e: tmp321-4654-9A645-BCT5K). Dans le cas d'une création de ligne le rowId généré par le serveur sera renvoyé dans la réponse.",
"type": "text"
},
{
"key": "tabId",
"value": "217434",
"description": "Utilisé en vue miroir uniquement, permet d'authentifier l'o_u sur les fieldValues et rowId passés",
"type": "text",
"disabled": true
},
{
"key": "bypassUrlTrigger",
"value": "false",
"description": "default: true, passer false si on veut déclencher des automatisations suite au modifs qu'on fait ici (url triggers / automatisations excels par exemple). Par défaut dans un soucis de performance les automatisation ne seront pas déclenchées via l'api.",
"type": "text",
"disabled": true
},
{
"key": "includeContextChanges",
"value": "true",
"description": "default: false, permet de récuperer les modifications découlant de celles qu'on fait ici (formules / lookups / changements d'ordre, de vue etc)",
"type": "text",
"disabled": true
},
{
"key": "fieldValues",
"value": "{\"123456\":\"Assigné\",\"7891011\":\"Lien 1, Lien 2\"}",
"description": "Clé valeur fieldId : valeur à modifier. On traite les liens comme une string concatenant les valeurs de la première colonne des éléments liés, séparées par des virgule (ou par ce qu'on a mis dans linkSeparator ci-dessous)",
"type": "text"
},
{
"key": "linkSeparator",
"value": "|",
"type": "text",
"disabled": true
}
]
},
"url": {
"raw": "https://timetonic.com/live/api.php",
"protocol": "https",
"host": [
"timetonic",
"com"
],
"path": [
"live",
"api.php"
]
}
},
"response": []
},
Exemple de recherche de valeurs dans une table
{
"name": "getTableValues Example",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"type": "text",
"value": "application/x-www-form-urlencoded"
}
],
"body": {
"mode": "urlencoded",
"urlencoded": [
{
"key": "req",
"value": "getTableValues",
"description": "nom de la requête",
"type": "text"
},
{
"key": "version",
"value": "6.49n",
"description": "version target de l'api",
"type": "text"
},
{
"key": "o_u",
"value": "",
"description": "code user corresondant à la sesskey",
"type": "text"
},
{
"key": "u_c",
"value": "",
"description": "code user corresondant à la sesskey, sert dans certains cas ou l'on veut écrire au nom d'un autre utilisateur (cas non couvert par cet exemple)",
"type": "text"
},
{
"key": "sesskey",
"value": "",
"description": "clé de session récupérée depuis le profil utilisateur",
"type": "text"
},
{
"key": "catId",
"value": "123456",
"description": "id de la table (anciennement \"category\") dont on veut récuperer les données (on l'obtient pour l'instant en inspectant dans le navigateur le résultat de la requête getCarnetFormCategory qui se produit quand on ouvre l'onglet qui nous intéresse)",
"type": "text"
},
{
"key": "filterRowIds",
"value": "{\n \"applyViewFilters\": {\n \"filterGroup\": {\n \"operator\": \"and\", \n \"filters\": [{\n \"id\": \"tmpId\", \n \"json\": {\n \"predicate\": \"after\", \n \"operand\": \"2020-05-01\"\n }, \n \"field_id\": \"1735324\", \n \"filter_type\": \"date\"\n }]\n }\n }\n}",
"description": "objet décrivant le filtre dynamique que l'on souhaite appliquer pour restreindre les résultats de cette requête",
"type": "text"
},
{
"key": "format",
"value": "rows",
"description": "Par défaut les résultats de cette requête sont retournés par colonne, passer format: rows permet de récuperer des lignes de valeur (la réponse à la requête est plus lourde dans ce cas)",
"type": "text",
"disabled": true
},
{
"key": "tabId",
"value": "654321",
"description": "Utilisé en vue miroir uniquement, permet d'authentifier l'o_u sur le catId passé ",
"type": "text"
},
{
"key": "offset",
"value": "1",
"description": "Quand on souhaite paginer les résultats, numéro de la page",
"type": "text"
},
{
"key": "maxRows",
"value": "100",
"description": "Quand on souhaite paginer les résultats, nombre d'enregistrement par page",
"type": "text"
}
]
},
"url": {
"raw": "https://timetonic.com/live/api.php",
"protocol": "https",
"host": [
"timetonic",
"com"
],
"path": [
"live",
"api.php"
]
}
},
"response": []
}
]
}