Simpan pengaturan profil

POST/api/crm/v2/profile.updatev2

operationId: profile.update

Sebagian memperbarui profil pengguna saat ini: hanya kunci yang dikirim yang diproses, bidang lainnya tidak berubah. Cocok untuk menyimpan satu bidang atau seluruh formulir dalam satu permintaan. Nilai kosong akan mengosongkan bidang (name, telegram_user_id, nomor telepon, photo). Jika nilai wajib, nilai kosong akan mengembalikan error 118: timezone, language, dan nomor telepon. Email tidak dapat diubah di sini: perubahan login memerlukan konfirmasi, gunakan profile.request_email_change dan profile.cancel_email_change untuk itu. Nomor telepon terdiri dari dua kunci, keduanya harus dikirim bersama: salah satu tanpa yang lain akan mengembalikan error 117. Perubahan kata sandi memerlukan old_password (error 128 jika tidak cocok), mengirim notifikasi ke email, dan mengakhiri semua sesi pengguna, termasuk sesi saat ini: kredensial telah berubah, sehingga perlu login ulang. Mengaktifkan 2FA memerlukan kode otp yang valid, mengakhiri semua sesi pengguna kecuali sesi saat ini, dan masa berlaku sesi saat ini dipersingkat hingga akhir hari berikutnya; menonaktifkan tidak demikian; otp_reset menghasilkan secret baru, membiarkan 2FA nonaktif, dan mengembalikan secret dan qr untuk pengikatan ulang.

Otorisasi

api-token + language + role

Isi permintaan `multipart/form-data`

object

namestringdapat bernilai null

Nilai kosong akan menghapus field

Contoh: John Smith

phone_format_idinteger (PhoneFormatId)

Kode negara: 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)

Contoh: 1

phone_numberstringdapat bernilai null

Hanya bersama dengan phone_format_id; nomor telepon wajib diisi

Contoh: (952) 056-31-65

telegram_user_idstringdapat bernilai null

Hanya angka; nilai kosong akan menghapus field

Contoh: 476962294

timezonestring

Contoh: Europe/Kaliningrad

languagestring

Contoh: ru

photostring · binarydapat bernilai null

File menggantikan avatar; kolom teks kosong menghapusnya

passwordstring

Kata sandi baru; hanya bersama dengan old_password

Contoh: 987654321

old_passwordstring

Kata sandi saat ini; wajib saat mengubah kata sandi

Contoh: 123456789

otp_enabledboolean

true mengaktifkan 2FA dan memerlukan otp, false menonaktifkannya

Contoh: true

otp_resetboolean

Mengeluarkan secret 2FA baru; 2FA tetap nonaktif hingga dihubungkan kembali

Contoh: false

otpstring

Kode rahasia saat ini; wajib saat mengaktifkan 2FA dan saat otp_reset

Contoh: 192870

Tanggapan

object

statusstringwajib

Nilai:successerror

Contoh: success

dataobject

descriptionstring

Contoh: Successfully saved

photostring

Ada, jika avatar diganti

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

secretstring

Tersedia saat otp_reset

Contoh: KA2G2UKBHBBHKOJR

qrstring

Ada jika otp_reset

Contoh: 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: id' \ -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' => 'id', '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": "id", "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": "id", "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" } }

Simpan pengaturan profil

Otorisasi

Isi permintaan multipart/form-data

Tanggapan

Isi permintaan `multipart/form-data`