Salva le impostazioni del profilo

POST/api/crm/v2/profile.updatev2

operationId: profile.update

Aggiorna parzialmente il profilo dell’utente corrente: vengono elaborati solo i campi trasmessi, gli altri rimangono invariati. Può essere usato sia per salvare un singolo campo che per salvare l’intero modulo con una sola richiesta.
Un valore vuoto cancella il campo (name, telegram_user_id, telefono, photo). Se il campo è obbligatorio, un valore vuoto restituisce l’errore 118: timezone, language e telefono.
L’email non viene modificata qui: il cambio login richiede conferma ed è gestito separatamente tramite profile.request_email_change e profile.cancel_email_change.
Il telefono è una coppia di chiavi che devono essere inviate insieme: l’invio di una senza l’altra restituisce l’errore 117.
Il cambio password richiede old_password (errore 128 se non corrisponde), invia una notifica via email e termina tutte le sessioni dell’utente, inclusa quella corrente: le credenziali sono cambiate, quindi è necessario effettuare nuovamente il login.
L’attivazione della 2FA richiede un codice otp valido, la disattivazione no; otp_reset genera un nuovo segreto, lascia la 2FA disattivata e restituisce secret e qr per una nuova configurazione.

Autorizzazione

api-token + language + role

Corpo della richiesta `multipart/form-data`

object

namestringpuò essere nullo

Un valore vuoto cancella il campo

Esempio: John Smith

phone_format_idinteger (PhoneFormatId)

Codice paese: 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)

Esempio: 1

phone_numberstringpuò essere nullo

Solo insieme a phone_format_id; il numero di telefono è obbligatorio

Esempio: (952) 056-31-65

telegram_user_idstringpuò essere nullo

Solo numeri; un valore vuoto cancella il campo

Esempio: 476962294

timezonestring

Esempio: Europe/Kaliningrad

languagestring

Esempio: ru

photostring · binarypuò essere nullo

Il file sostituisce l’avatar; un campo di testo vuoto lo rimuove

passwordstring

Nuova password; solo insieme a old_password

Esempio: 987654321

old_passwordstring

Password attuale; obbligatorio per la modifica della password

Esempio: 123456789

otp_enabledboolean

true abilita 2FA e richiede otp, false la disabilita

Esempio: true

otp_resetboolean

Genera un nuovo segreto 2FA; 2FA rimane disattivato fino al nuovo collegamento

Esempio: false

otpstring

Codice del segreto attuale; obbligatorio per l’attivazione del 2FA e per otp_reset

Esempio: 192870

Risposte

object

statusstringobbligatorio

Valori:successerror

Esempio: success

dataobject

descriptionstring

Esempio: Successfully saved

photostring

Presente, se l’avatar è stato sostituito

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

secretstring

Presente per otp_reset

Esempio: KA2G2UKBHBBHKOJR

qrstring

Presente per otp_reset

Esempio: 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: it' \ -H 'role: affiliate' \ -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' => 'it', 'role' => 'affiliate', ], '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": "it", "role": "affiliate" }, 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": "it", "role": "affiliate", }, 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" } }

Salva le impostazioni del profilo

Autorizzazione

Corpo della richiesta multipart/form-data

Risposte

Corpo della richiesta `multipart/form-data`