Enregistrer les paramètres du profil

POST/api/crm/v2/profile.updatev2

operationId: profile.update

Met à jour partiellement le profil de l'utilisateur actuel : seuls les champs transmis sont traités, les autres restent inchangés. Convient aussi bien pour enregistrer un seul champ que pour sauvegarder tout le formulaire en une seule requête.

Une valeur vide efface le champ (name, telegram_user_id, téléphone, photo). Si la valeur est obligatoire, une valeur vide retourne l’erreur 118 : timezone, language et téléphone.

L’email n’est pas modifié ici : le changement de login nécessite une confirmation et dispose d’opérations séparées profile.request_email_change et profile.cancel_email_change.

Le téléphone est une paire de clés, elles doivent être transmises ensemble : l’une sans l’autre retourne l’erreur 117. Le changement de mot de passe requiert old_password (erreur 128 si incorrect), envoie une notification par email et termine toutes les sessions utilisateur, y compris l’actuelle : les identifiants ayant changé, il faut se reconnecter. L’activation du 2FA nécessite un code otp valide, la désactivation non ; otp_reset génère un nouveau secret, laisse le 2FA désactivé et retourne secret et qr pour une nouvelle liaison.

Autorisation

api-token + language + role

Corps de la requête `multipart/form-data`

object

namestringpeut être nul

Une valeur vide efface le champ

Exemple: John Smith

phone_format_idinteger (PhoneFormatId)

Code du pays : 1-🇷🇺(+7|8), 2-🇦🇿(+994|0), 3-🇧🇾(+375|80), 4-🇰🇿(+7|8), 6-🇷🇸(+381|0), 7-🇹🇷(+90|0), 8-🇺🇦(+380|0), 9-🇵🇹(+351|0), 10-🇰🇬(+996|0), 11-🇺🇸(+1), 12-🇫🇷(+33|0), 13-🇲🇩(+373|0), 15-🇪🇪(+372), 18-🇬🇪(+995), 19-🇺🇿(+998), 22-🇵🇱(+48|0), 23-🇹🇯(+992|8), 25-🇷🇴(+40|0), 44-🇨🇭(+41|0)

Exemple: 1

phone_numberstringpeut être nul

Uniquement avec phone_format_id ; le numéro de téléphone est obligatoire

Exemple: (952) 056-31-65

telegram_user_idstringpeut être nul

Chiffres uniquement ; une valeur vide réinitialise le champ

Exemple: 476962294

timezonestring

Exemple: Europe/Kaliningrad

languagestring

Exemple: ru

photostring · binarypeut être nul

Le fichier remplace l’avatar ; un champ texte vide le supprime

passwordstring

Nouveau mot de passe ; uniquement avec old_password

Exemple: 987654321

old_passwordstring

Mot de passe actuel ; requis lors du changement de mot de passe

Exemple: 123456789

otp_enabledboolean

true active l’authentification à deux facteurs et requiert otp, false la désactive

Exemple: true

otp_resetboolean

Génère un nouveau secret 2FA ; 2FA reste désactivée jusqu'à une nouvelle liaison

Exemple: false

otpstring

Code du secret actuel ; requis lors de l’activation de la 2FA et lors de otp_reset

Exemple: 192870

Réponses

object

statusstringobligatoire

Valeurs:successerror

Exemple: success

dataobject

descriptionstring

Exemple: Successfully saved

photostring

Existe si l’avatar a été remplacé

Exemple: data:image/jpeg;base64,/9j/4AAQSkZJRg...

secretstring

Présent lors de otp_reset

Exemple: KA2G2UKBHBBHKOJR

qrstring

Présent lors de otp_reset

Exemple: https://api.qrserver.com/v1/create-qr-code/?data=otpauth%3A%2F%2Ftotp%2FFS%2520Admin%3Akalabunga82%40gmail.com%3Fsecret%3DKA2G2UKBHBBHKOJR%26issuer%3DFS%2520Admin&size=520x520&margin=15

curl -X POST 'https://foodsoul.ru/api/crm/v2/profile.update' \ -H 'Authorization: Bearer fs_api_YOUR_TOKEN' \ -H 'language: fr' \ -H 'role: partner' \ -F 'name=John Smith' \ -F 'phone_format_id=1' \ -F 'phone_number=(952) 056-31-65' \ -F 'telegram_user_id=476962294' \ -F 'timezone=Europe/Kaliningrad' \ -F 'language=ru' \ -F 'photo=@file.jpg' \ -F 'password=987654321' \ -F 'old_password=123456789' \ -F 'otp_enabled=true' \ -F 'otp_reset=false' \ -F 'otp=192870'

<?php $client = new \GuzzleHttp\Client(); $response = $client->request('POST', 'https://foodsoul.ru/api/crm/v2/profile.update', [ 'headers' => [ 'Authorization' => 'Bearer fs_api_YOUR_TOKEN', 'language' => 'fr', 'role' => 'partner', ], 'multipart' => [ [ 'name' => 'name', 'contents' => 'John Smith', ], [ 'name' => 'phone_format_id', 'contents' => '1', ], [ 'name' => 'phone_number', 'contents' => '(952) 056-31-65', ], [ 'name' => 'telegram_user_id', 'contents' => '476962294', ], [ 'name' => 'timezone', 'contents' => 'Europe/Kaliningrad', ], [ 'name' => 'language', 'contents' => 'ru', ], [ 'name' => 'photo', 'contents' => '<file>', ], [ 'name' => 'password', 'contents' => '987654321', ], [ 'name' => 'old_password', 'contents' => '123456789', ], [ 'name' => 'otp_enabled', 'contents' => 'true', ], [ 'name' => 'otp_reset', 'contents' => 'false', ], [ 'name' => 'otp', 'contents' => '192870', ], ], ]); $data = json_decode((string) $response->getBody(), true);

const body = new FormData() body.append("name", "John Smith") body.append("phone_format_id", "1") body.append("phone_number", "(952) 056-31-65") body.append("telegram_user_id", "476962294") body.append("timezone", "Europe/Kaliningrad") body.append("language", "ru") body.append("photo", "<file>") body.append("password", "987654321") body.append("old_password", "123456789") body.append("otp_enabled", "true") body.append("otp_reset", "false") body.append("otp", "192870") const response = await fetch("https://foodsoul.ru/api/crm/v2/profile.update", { method: "POST", headers: { "Authorization": "Bearer fs_api_YOUR_TOKEN", "language": "fr", "role": "partner" }, body, }) const data = await response.json()

import requests response = requests.request( "POST", "https://foodsoul.ru/api/crm/v2/profile.update", headers={ "Authorization": "Bearer fs_api_YOUR_TOKEN", "language": "fr", "role": "partner", }, files={ "name": [ None, "John Smith", ], "phone_format_id": [ None, "1", ], "phone_number": [ None, "(952) 056-31-65", ], "telegram_user_id": [ None, "476962294", ], "timezone": [ None, "Europe/Kaliningrad", ], "language": [ None, "ru", ], "photo": [ None, "<file>", ], "password": [ None, "987654321", ], "old_password": [ None, "123456789", ], "otp_enabled": [ None, "true", ], "otp_reset": [ None, "false", ], "otp": [ None, "192870", ], }, ) data = response.json()

{ "status": "success", "data": { "description": "Successfully saved", "photo": "data:image/jpeg;base64,/9j/4AAQSkZJRg...", "secret": "KA2G2UKBHBBHKOJR", "qr": "https://api.qrserver.com/v1/create-qr-code/?data=otpauth%3A%2F%2Ftotp%2FFS%2520Admin%3Akalabunga82%40gmail.com%3Fsecret%3DKA2G2UKBHBBHKOJR%26issuer%3DFS%2520Admin&size=520x520&margin=15" } }

Enregistrer les paramètres du profil

Autorisation

Corps de la requête multipart/form-data

Réponses

Corps de la requête `multipart/form-data`