Saglabāt profila iestatījumus

POST/api/crm/v2/profile.updatev2

operationId: profile.update

Daļēji atjaunina pašreizējā lietotāja profilu: tiek apstrādātas tikai norādītās atslēgas, pārējie lauki netiek mainīti. Piemērots gan viena lauka saglabāšanai, gan visas formas saglabāšanai ar vienu pieprasījumu.
Tukša vērtība notīra lauku (name, telegram_user_id, tālrunis, photo). Ja vērtība ir obligāta, tukša vērtība atgriež kļūdu 118: timezone, language un tālrunis.
E-pasts šeit netiek mainīts: pieteikšanās maiņai nepieciešams apstiprinājums, tam ir atsevišķi profile.request_email_change un profile.cancel_email_change.
Tālrunis — pāris atslēgu, tās jānosūta kopā: viena bez otras atgriež kļūdu 117. Paroles maiņai nepieciešams old_password (kļūda 128, ja nesakrīt), nosūta paziņojumu uz e-pastu un izbeidz visas lietotāja sesijas, tostarp pašreizējo: akreditācijas dati ir mainīti, tāpēc nepieciešama atkārtota pieteikšanās. 2FA ieslēgšanai nepieciešams korekts otp kods, izslēgšanai — nav nepieciešams; otp_reset izsniedz jaunu slepeno atslēgu, atstāj 2FA izslēgtu un atgriež secret un qr jaunai piesaistei.

Autorizācija

api-token + language + role

Pieprasījuma saturs `multipart/form-data`

object

namestringvar būt null

Tukša vērtība notīra lauku

Piemērs: John Smith

phone_format_idinteger (PhoneFormatId)

Valsts kods: 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)

Piemērs: 1

phone_numberstringvar būt null

Tikai kopā ar phone_format_id; tālrunis ir obligāts

Piemērs: (952) 056-31-65

telegram_user_idstringvar būt null

Tikai cipari; tukša vērtība notīra lauku

Piemērs: 476962294

timezonestring

Piemērs: Europe/Kaliningrad

languagestring

Piemērs: ru

photostring · binaryvar būt null

Fails aizstāj avatāru; tukšs teksta lauks to dzēš

passwordstring

Jauna parole; tikai kopā ar old_password

Piemērs: 987654321

old_passwordstring

Pašreizējā parole; obligāti jānorāda, mainot paroli

Piemērs: 123456789

otp_enabledboolean

true ieslēdz 2FA un pieprasa otp, false to izslēdz

Piemērs: true

otp_resetboolean

Izsniedz jaunu 2FA slepeno atslēgu; 2FA paliek izslēgta līdz jaunai sasaistīšanai

Piemērs: false

otpstring

Pašreizējā slepenā koda kods; obligāts, ieslēdzot 2FA un pie otp_reset

Piemērs: 192870

Atbildes

object

statusstringobligāts

Vērtības:successerror

Piemērs: success

dataobject

descriptionstring

Piemērs: Successfully saved

photostring

Ir, ja avatars ir nomainīts

Piemērs: data:image/jpeg;base64,/9j/4AAQSkZJRg...

secretstring

Ir pie otp_reset

Piemērs: KA2G2UKBHBBHKOJR

qrstring

Ir, ja otp_reset

Piemērs: 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: lv' \
  -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' => 'lv',
        '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": "lv",
        "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": "lv",
        "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()

Atbilde 200

{
  "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"
  }
}

Pieprasījumi tiek nosūtīti uz foodsoul.pro — šī portāla resursdatoru, citu izvēlēties nav iespējams.

Saglabāt profila iestatījumus

Autorizācija

Pieprasījuma saturs multipart/form-data

Atbildes

Pieprasījuma saturs `multipart/form-data`