Profileinstellungen speichern

POST/api/crm/v2/profile.updatev2

operationId: profile.update

Aktualisiert teilweise das Profil des aktuellen Benutzers: Es werden nur die übergebenen Schlüssel verarbeitet, andere Felder bleiben unverändert. Geeignet sowohl zum Speichern eines einzelnen Feldes als auch zum Speichern des gesamten Formulars in einer Anfrage.

Ein leerer Wert leert das Feld (name, telegram_user_id, Telefonnummer, photo). Ist ein Wert erforderlich, führt ein leerer Wert zu Fehler 118: timezone, language und Telefonnummer.

Die E-Mail-Adresse wird hier nicht geändert: Eine Änderung des Logins erfordert eine Bestätigung, dafür gibt es separate Operationen profile.request_email_change und profile.cancel_email_change.

Telefonnummer besteht aus einem Schlüsselpaar, beide müssen zusammen übergeben werden: Einer ohne den anderen führt zu Fehler 117. Eine Passwortänderung erfordert old_password (Fehler 128, wenn es nicht übereinstimmt), sendet eine Benachrichtigung an die E-Mail-Adresse und beendet alle Benutzersitzungen, einschließlich der aktuellen: Die Zugangsdaten wurden geändert, daher ist eine erneute Anmeldung erforderlich. Das Aktivieren von 2FA erfordert einen gültigen otp-Code, das Deaktivieren nicht; otp_reset generiert ein neues Geheimnis, lässt 2FA deaktiviert und gibt secret und qr für eine neue Kopplung zurück.

Autorisierung

api-token + language + role

Anfragetext `multipart/form-data`

object

namestringkann null sein

Ein leerer Wert löscht das Feld

Beispiel: John Smith

phone_format_idinteger (PhoneFormatId)

Ländercode: 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)

Beispiel: 1

phone_numberstringkann null sein

Nur zusammen mit phone_format_id; Telefonnummer ist erforderlich

Beispiel: (952) 056-31-65

telegram_user_idstringkann null sein

Nur Ziffern; ein leerer Wert setzt das Feld zurück

Beispiel: 476962294

timezonestring

Beispiel: Europe/Kaliningrad

languagestring

Beispiel: ru

photostring · binarykann null sein

Die Datei ersetzt den Avatar; ein leeres Textfeld entfernt ihn

passwordstring

Neues Passwort; nur zusammen mit old_password

Beispiel: 987654321

old_passwordstring

Aktuelles Passwort; erforderlich bei Passwortänderung

Beispiel: 123456789

otp_enabledboolean

true aktiviert 2FA und erfordert otp, false deaktiviert sie

Beispiel: true

otp_resetboolean

Gibt ein neues 2FA-Secret aus; 2FA bleibt deaktiviert, bis eine neue Verknüpfung erfolgt

Beispiel: false

otpstring

Code des aktuellen Geheimnisses; erforderlich bei Aktivierung von 2FA und bei otp_reset

Beispiel: 192870

Antworten

object

statusstringerforderlich

Werte:successerror

Beispiel: success

dataobject

descriptionstring

Beispiel: Successfully saved

photostring

Vorhanden, wenn der Avatar ersetzt wurde

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

secretstring

Vorhanden bei otp_reset

Beispiel: KA2G2UKBHBBHKOJR

qrstring

Vorhanden bei otp_reset

Beispiel: 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.pro/api/crm/v2/profile.update' \ -H 'Authorization: Bearer fs_api_YOUR_TOKEN' \ -H 'language: de' \ -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.pro/api/crm/v2/profile.update', [ 'headers' => [ 'Authorization' => 'Bearer fs_api_YOUR_TOKEN', 'language' => 'de', '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.pro/api/crm/v2/profile.update", { method: "POST", headers: { "Authorization": "Bearer fs_api_YOUR_TOKEN", "language": "de", "role": "affiliate" }, body, }) const data = await response.json()

import requests response = requests.request( "POST", "https://foodsoul.pro/api/crm/v2/profile.update", headers={ "Authorization": "Bearer fs_api_YOUR_TOKEN", "language": "de", "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" } }

Profileinstellungen speichern

Autorisierung

Anfragetext multipart/form-data

Antworten

Anfragetext `multipart/form-data`