Метод используется для принятия соглашения от имени текущего пользователя для аккаунта, к которому у него есть доступ. Пользователи могут принимать соглашение для аккаунта множество раз (например, при создании аккаунта, при первом входе, при покупке каждой подписки, при запросе обновления соглашения). В результате вызова метода создается или обновляется соглашение:
-
Правила продаж — поддерживается создание и обновление.
-
Клиентское соглашение Microsoft — поддерживается только обновление. При этом данные на стороне Microsoft не будут обновлены, если контактные данные клиента не изменились (A partner confirmed agreement already exists for the customer). Принятие клиентского соглашения Microsoft выполняется отдельно, при оформлении заказа на покупку первой подписки Microsoft (см. Получение списка дополнительных атрибутов заказа и Валидация дополнительных атрибутов заказа).
Метод возвращает пустой ответ. Код ответа 204 No content.
POST {reseller_domain}/internal_api/accounts/{account_id}/agreement_acceptances
В этой статье:
Авторизация
Требуется авторизация с помощью access token пользователя.
Аргументы
|
Название |
Тип параметра |
Тип данных |
Обязательный/
|
Описание |
|
|---|---|---|---|---|---|
|
Content-Type |
header |
string |
Обязательный |
Тип данных, передаваемых в запросе. Укажите application/vnd.api+json |
|
|
Accept |
header |
string |
Обязательный |
Поддерживаемые типы данных в ответе. Укажите application/vnd.api+json |
|
|
X-Api-Locale |
header |
string |
Опциональный |
Двухбуквенный код языка данных в ответе |
|
|
Authorization |
header |
string |
Обязательный |
Действующий access token пользователя. Формат: |
|
|
reseller_domain |
path |
string |
Обязательный |
Доменное имя реселлера |
|
|
account_id |
path |
integer |
Обязательный |
ID аккаунта |
|
|
attributes |
form |
object |
Обязательный |
Параметры принятых соглашений |
|
|
|
agreement_confirmed |
form |
bool |
Обязательный |
Признак принятия соглашения. Укажите значение true — аккаунт принимает соглашение |
|
|
agreement_type |
form |
bool |
Обязательный |
Тип соглашения:
|
Пример запроса
curl --location --request POST 'https://test.activeplatform.com/internal_api/accounts/1945/agreement_acceptances' \
--header 'Content-Type: application/vnd.api+json' \
--header 'Accept: application/vnd.api+json' \
--header 'X-Api-Locale: en' \
--header 'Authorization: Bearer AccessTokenExample' \
--data-raw '{
"data": {
"attributes": {
"agreement_confirmed": true,
"agreement_type": "terms_and_conditions"
}
}
}'