API

Պահպանել պրոֆիլի կարգավորումները

POST/api/crm/v2/profile.updatev2
operationId: profile.update

Մասնակիորեն թարմացնում է ընթացիկ օգտագործողի պրոֆիլը․ մշակվում են միայն փոխանցված բանալիները, մնացած դաշտերը չեն փոխվում։ Հարմար է ինչպես մեկ դաշտի պահպանման, այնպես էլ ամբողջ ձևի մեկ հարցմամբ պահպանման համար։
Դատարկ արժեքը մաքրում է դաշտը (name, telegram_user_id, հեռախոս, photo)։ Եթե արժեքը պարտադիր է, դատարկը վերադարձնում է սխալ 118՝ timezone, language և հեռախոս։
Email-ը այստեղ չի փոխվում․ մուտքի փոփոխությունը պահանջում է հաստատում, դրա համար առկա են առանձին profile.request_email_change և profile.cancel_email_change։
Հեռախոսը՝ բանալիների զույգ է, փոխանցվում են միասին․ մեկը առանց մյուսի վերադարձնում է սխալ 117։ Գաղտնաբառի փոփոխությունը պահանջում է old_password (սխալ 128, եթե չի համընկնում), ուղարկում է ծանուցում email-ին և ավարտում է օգտագործողի բոլոր սեսիաները, ներառյալ ընթացիկը․ հավատարմագրերը փոխվել են, ուստի անհրաժեշտ է նորից մուտք գործել։ 2FA-ի միացումը պահանջում է ճիշտ otp կոդ, անջատումը՝ ոչ․ otp_reset-ը թողարկում է նոր գաղտնիք, թողնում է 2FA-ն անջատված և վերադարձնում է secret և qr նոր կապման համար։.

Հավաստագրում

api-token + language + role

Հարցման մարմին multipart/form-data

object
namestringկարող է լինել null

Դատարկ արժեքը մաքրում է դաշտը

Օրինակ: John Smith

phone_format_idinteger (PhoneFormatId)

Երկրի կոդ՝ 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)

Օրինակ: 1

phone_numberstringկարող է լինել null

Միայն phone_format_id-ի հետ միասին; հեռախոսահամարը պարտադիր է

Օրինակ: (952) 056-31-65

telegram_user_idstringկարող է լինել null

Միայն թվեր; դատարկ արժեքը մաքրում է դաշտը

Օրինակ: 476962294

timezonestring

Օրինակ: Europe/Kaliningrad

languagestring

Օրինակ: ru

photostring · binaryկարող է լինել null

Ֆայլը փոխարինում է ավատարը, դատարկ տեքստային դաշտը հեռացնում է այն

passwordstring

Նոր գաղտնաբառ; միայն old_password-ի հետ

Օրինակ: 987654321

old_passwordstring

Ընթացիկ գաղտնաբառը; պարտադիր է գաղտնաբառը փոխելու դեպքում

Օրինակ: 123456789

otp_enabledboolean

true միացնում է 2FA-ն և պահանջում է otp, false անջատում է այն

Օրինակ: true

otp_resetboolean

Նոր 2FA գաղտնիք է թողարկում; 2FA-ն մնում է անջատված մինչև նոր կապակցումը

Օրինակ: false

otpstring

Ընթացիկ գաղտնիքի կոդը; պարտադիր է 2FA միացնելու և otp_reset դեպքում

Օրինակ: 192870

Պատասխաններ

OK

object
statusstringպարտադիր

Արժեքներ:successerror

Օրինակ: success

dataobject
descriptionstring

Օրինակ: Successfully saved

photostring

Կա, եթե ավատարը փոխված է

Օրինակ: data:image/jpeg;base64,/9j/4AAQSkZJRg...

secretstring

Առկա է otp_reset դեպքում

Օրինակ: KA2G2UKBHBBHKOJR

qrstring

Առկա է otp_reset

Օրինակ: 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