Mise à jour d’un sous objet
Nous allons maintenant voir comment mettre à jour un objet.
Requête
Le chemin d’accès à toujours la même forme, il faut obligatoirement spécifier l’id de la ressource.
https://{account_subdomain}.nicoka.com/api/{resource_name_in_plural}/{id_of_the_resource}/{branch_name}/{id_of_the_branch_in_line} POST
Remarque
{id_of_the_branch_in_line} il s’agit généralement de l’id (un identifiant numérique) du sous objet, parfois les sous objets ont un identifiant composite (plusieurs champs pour définir une clé uniquement) dans ce cas l’id aura la forme suivante : {id_of_the_resource}:{key_field_2}…:{key_field_n}
Exemple :
curl https://{account_subdomain}.nicoka.com/api/employees/1/languages/1:en/
-H "Authorization: Bearer
eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxIiwiZXhwIjoxNTQ4MTAyNTExfQ.a96H A5xozI_6TE65ybC5RsXdOfSuHd4Wbmhswb-V1nw"
-X POST
Remarque
Il faut utiliser la méthode « POST ».
Exemple de modification du champ « level » pour le sous objet langues parlés (languages), voici le corps de la requête :
- {
- "level": "1",
- }
Réponse
- {
- "success": "Ressource Lex Luthor a été modifiée",
- "object":
- {
- "label": "Lex Luthor",
- "employeeid": "1",
- "code": "",
- "status": "1",
- "todo_state": "100",
- "last_name": "Lex",
- "middle_name": "Peter",
- "first_name": "Lex",
- ...
- "loekz": "0",
- "cdate": "2012-01-22 12:33:28",
- "cname": "1",
- "udate": "2018-01-22 12:33:28",
- "uname": "4",
- "versi": "106",
- }
- "languages":
- {
- "id": "1:en",
- "label": "Anglais",
- "employeeid": "1",
- "code": "en",
- "level": "1",
- "updateLink": "?mod=employees&act=languages&sac=update&inlineid=1:en",
- "employeeid__formated": "Lex Luthor",
- "code__formated": "Anglais",
- "level__formated": "Débutant",
- }
- }