Mindbox
Редактирование данных клиента

json

В инструкции описаны примеры POST-запросов. Интеграция с Mindbox не будет работать, если использовать запросы из примеров ниже без редактирования.

Операции именно под вашу задачу создает и описывает в техническом задании менеджер проекта, если у вас нет такого документа, то обратитесь к вашему менеджеру.

Описание метода

Осуществляется с помощью POST-запроса. Название операции и набор принимаемых полей настраиваются в системе Майндбокс. Подробней про вызов метода можно прочитать здесь.

JSONУниверсальная операция
POST https://api.mindbox.ru/v3/operations/{синхронная/асинхронная операция}?endpointId={уникальный идентификатор сайта/мобильного приложения/и т.п.}&operation={название операции}&deviceUUID={уникальный идентификатор устройства}

Accept: application/json
Content-Type: application/json
Authorization: SecretKey {Секретный ключ, обязательность уточнить у менеджера}

{
    "customer": {
        "authenticationTicket": "{Секретный тикет}",
        "ids": {
            "webSiteUserId": "{Идентификатор клиента}"
        },
        "email": "{Емэйл клиента}",
        "mobilePhone": "{Мобильный телефон}",
        "lastName": "{Фамилия клиента}",
        "firstName": "{Имя клиента}",
        "birthDate": "{Дата рождения в формате YYYY-MM-DD}",
        "password": "{Пароль}",
        "subscriptions": [
            {
                "pointOfContact": "{Канал коммуникации Email/SMS/тд}",
                "topic": "{Тематика рассылок}",
                "isSubscribed": "{Статус подписки true/false}"
            }
        ],
        "customFields": {
            "Дополнительное поле": "{Значение дополнительного поля}"
        }
    }
}

Секретный тикет нужен, если сервис вызывается без секретного ключа напрямую с клиента. Его можно сформировать самостоятельно по алгоритму описанному здесь
Также он может понадобится, если потребитель не аутентифицирован и переходит из письма по секретной ссылке. Тогда тикет берется из ссылки.

Чтобы затереть поле, надо передать значение %CLEAR%. Например: "mobilePhone": "%CLEAR%"

Примеры операций

JSONCode
POST https://api.mindbox.ru/v3/operations/async?endpointId=MindboxRu&operation=EditCustomer

Accept: application/json
Content-Type: application/json
Authorization: SecretKey D061p764m85bklq

{
    "customer": {
        "ids": {
            "bitrixId": "346257"
        },
        "email": "pivan@mindbox.ru",
        "mobilePhone": 79374134389,
        "lastName": "Петров",
        "firstName": "Иван",
        "password": "Qwerty",
        "customFields": {
            "city": "Mосква",
            "b2b": true
        },
        "subscriptions": [
            {
                "pointOfContact": "Sms",
                "topic": "Recommendation",
                "isSubscribed": false
            },
            {
                "pointOfContact": "Email",
                "topic": "Recommendation",
                "isSubscribed": true
            }
        ]
    }
}
Last modified on
javascriptРеферальная программа