Guardar la configuración del perfil

POST/api/crm/v2/profile.updatev2

operationId: profile.update

Actualiza parcialmente el perfil del usuario actual: solo se procesan las claves enviadas, los demás campos no se modifican. Es adecuado tanto para guardar un solo campo como para guardar todo el formulario en una sola solicitud.
Un valor vacío limpia el campo (name, telegram_user_id, teléfono, photo). Si el valor es obligatorio, un valor vacío devuelve el error 118: timezone, language y teléfono.
El email no se cambia aquí: el cambio de login requiere confirmación y tiene operaciones separadas profile.request_email_change y profile.cancel_email_change.
El teléfono es un par de claves, deben enviarse juntas: una sin la otra devuelve el error 117. Cambiar la contraseña requiere old_password (error 128 si no coincide), envía una notificación al email y finaliza todas las sesiones del usuario, incluida la actual: las credenciales han cambiado, por lo que es necesario iniciar sesión de nuevo.
La activación de 2FA requiere un código otp válido, la desactivación no; otp_reset genera un nuevo secreto, deja 2FA desactivado y devuelve secret y qr para una nueva vinculación.

Autorización

api-token + language + role

Cuerpo de la solicitud `multipart/form-data`

object

namestringpuede ser nulo

Un valor vacío limpia el campo

Ejemplo: John Smith

phone_format_idinteger (PhoneFormatId)

Código de país: 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)

Ejemplo: 1

phone_numberstringpuede ser nulo

Solo junto con phone_format_id; el teléfono es obligatorio

Ejemplo: (952) 056-31-65

telegram_user_idstringpuede ser nulo

Solo dígitos; un valor vacío limpia el campo

Ejemplo: 476962294

timezonestring

Ejemplo: Europe/Kaliningrad

languagestring

Ejemplo: ru

photostring · binarypuede ser nulo

El archivo reemplaza el avatar; un campo de texto vacío lo elimina

passwordstring

Nueva contraseña; solo junto con old_password

Ejemplo: 987654321

old_passwordstring

Contraseña actual; obligatoria al cambiar la contraseña

Ejemplo: 123456789

otp_enabledboolean

true activa 2FA y requiere otp, false la desactiva

Ejemplo: true

otp_resetboolean

Emite un nuevo secreto 2FA; 2FA permanece desactivado hasta que se vuelva a vincular

Ejemplo: false

otpstring

Código del secreto actual; obligatorio al habilitar 2FA y al usar otp_reset

Ejemplo: 192870

Respuestas

object

statusstringobligatorio

Valores:successerror

Ejemplo: success

dataobject

descriptionstring

Ejemplo: Successfully saved

photostring

Existe si el avatar ha sido reemplazado

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

secretstring

Está presente en otp_reset

Ejemplo: KA2G2UKBHBBHKOJR

qrstring

Está presente en otp_reset

Ejemplo: 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: es' \ -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' => 'es', '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": "es", "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": "es", "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" } }

Guardar la configuración del perfil

Autorización

Cuerpo de la solicitud multipart/form-data

Respuestas

Cuerpo de la solicitud `multipart/form-data`