Taotle e-posti aadressi muutmist

POST/api/crm/v2/profile.request_email_changev2

operationId: profile.requestEmailChange

Loob taotluse kasutajanime muutmiseks ja saadab kinnituse lingi uuele aadressile. Praegune email kehtib seni, kuni kasutaja klikib lingil; link kehtib 24 tundi. Kasutajal saab olla ainult üks taotlus: korduv päring kirjutab eelmise üle ja muudab selle lingi kehtetuks. Veakoodid: 332 — aadress kattub praegusega, 111 — aadress on juba kasutusel, 333 — kiri on juba saadetud, proovige hiljem uuesti.

Autoriseerimine

api-token + language + role

Päringu keha `application/json`

object

emailstringkohustuslik

Näide: new@fs.pro

Vastused

object

statusstringkohustuslik

Väärtused:successerror

Näide: success

dataobject

descriptionstring

Näide: Successfully saved

email_confirmationobject

Loodud päring — selle põhjal kuvab liides ooteoleku koos tühistamisnupuga

emailstring

Näide: new@fs.pro

date_creationstring (DataTimeFormatSQL)

Näide: 2024-05-02 08:31:16

date_expirationstring (DataTimeFormatSQL)

Näide: 2024-05-02 08:31:16

curl -X POST 'https://foodsoul.pro/api/crm/v2/profile.request_email_change' \
  -H 'Authorization: Bearer fs_api_YOUR_TOKEN' \
  -H 'language: et' \
  -H 'role: partner' \
  -H 'Content-Type: application/json' \
  -d '{"email":"new@fs.pro"}'

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://foodsoul.pro/api/crm/v2/profile.request_email_change', [
    'headers' => [
        'Authorization' => 'Bearer fs_api_YOUR_TOKEN',
        'language' => 'et',
        'role' => 'partner',
    ],
    'json' => [
        'email' => 'new@fs.pro',
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch("https://foodsoul.pro/api/crm/v2/profile.request_email_change", {
    method: "POST",
    headers: {
        "Authorization": "Bearer fs_api_YOUR_TOKEN",
        "language": "et",
        "role": "partner",
        "Content-Type": "application/json"
    },
    body: JSON.stringify({
        "email": "new@fs.pro"
    }),
})
const data = await response.json()

import requests

response = requests.request(
    "POST",
    "https://foodsoul.pro/api/crm/v2/profile.request_email_change",
    headers={
        "Authorization": "Bearer fs_api_YOUR_TOKEN",
        "language": "et",
        "role": "partner",
    },
    json={
        "email": "new@fs.pro",
    },
)
data = response.json()

Vastus 200

{
  "status": "success",
  "data": {
    "description": "Successfully saved",
    "email_confirmation": {
      "email": "new@fs.pro",
      "date_creation": "2024-05-02 08:31:16",
      "date_expiration": "2024-05-02 08:31:16"
    }
  }
}

Päringud saadetakse aadressile foodsoul.pro — see on selle portaali host, teist valida ei saa.

Taotle e-posti aadressi muutmist

Autoriseerimine

Päringu keha application/json

Vastused

Päringu keha `application/json`