Un des besoins les plus courants est de vouloir ajouter une nouvelle ligne ou modifier les valeurs d'une ligne existante via l'API.

Pour créer ou modifier une ligne (row) ou les données d'une ligne (row), la requête API est createOrUpdateTableRow.

Pour créer ou modifier plusieurs lignes (rows), ou les données de plusieurs lignes (rows), la requête API est createOrUpdateTableRows.

1. Créer une nouvelle ligne

Une fois récupérés les identifiants des colonnes (fields) d'une table avec getTableValues, rien de plus simple pour créer une nouvelle ligne.

Depuis le site dédié à l'API, utilisez la fonction createOrUpdateTableRow. en indiquant tmpNEW_ROW comme valeur pour le paramètre rowID.

Voici un exemple de requête. Remplacez bien sûr userID par votre identifiant d'utilisateur et sessionID par votre clé API (Sesskey), et fieldID1, fieldID2, fieldID3 et fieldID4 par les bons identifiants de colonnes (fields):

https://timetonic.com/live/api.php?req=createOrUpdateTableRow&version=5.71&o_u=userID &u_c=userID &sesskey=sessionID &rowId=tmpNEW_ROW&fieldValues={"fieldID1":"Valeur premier champ","fieldID2":"Valeur second champ","fieldID3":"Valeur troisième champ","fieldID4":"Valeur quatrième champ"}

Note : il est recommandé de passer les paramètres en POST plutôt qu’en GET mais pour l’exemple c’est plus facile à tester.

2. Modifier les valeurs d'un ou plusieurs champs d'une ligne existante

Une fois récupérés les identifiants des colonnes (fields) et des lignes (rows) d'une table avec getTableValues, rien de plus simple pour modifier les valeurs d'une ligne (row) existante.

Depuis le site dédié à l'API, utilisez la fonction createOrUpdateTableRow. en spécifiant l'identifiant de la ligne comme valeur pour le paramètre rowID.

Voici un exemple de requête. Remplacez bien sûr userID par votre identifiant d'utilisateur et sessionID par votre clé API (Sesskey), rowIDtoUpdate par l'identifiant de la ligne (row) et fieldID1, fieldID2, fieldID3 et fieldID4 par les bons identifiants de colonnes (fields):

https://timetonic.com/live/api.php?req=createOrUpdateTableRow&version=5.71&o_u=userID &u_c=userID &sesskey=sessionID &rowId=rowIDtoUpdate&fieldValues={"fieldID1":"Nouvelle valeur premier champ","fieldID2":"Nouvelle valeur second champ","fieldID3":"Nouvelle valeur troisième champ","fieldID4":"Nouvelle valeur quatrième champ"}

Note : il est recommandé de passer les paramètres en POST plutôt qu’en GET mais pour l’exemple c’est plus facile à tester.