В большинстве запросов к серверу Sailplay необходимо передавать идентификатор клиента (client ID), чтобы выполнить с ним определённые действия. Например, такие как:
- проверить, существует ли он в базе данных;
- присвоить тег;
- связать с покупкой и т.д.
В документации к методам в качестве идентификатора клиента мы указываем телефон клиента — user_phone. Однако допускается передавать и другой идентификатор: emailили origin_user_id.
Дополнительные идентификаторы клиента
В Sailplay есть возможность указывать дополнительные идентификаторы для клиентов и использовать их при интеграции при отправке API-запросов. В качестве идентификаторов можно использовать:
- cookie-файлы с сайта;
- второй номер телефона;
- второй email и т.д.
Все существующие публичные API-методы, которые принимают user_phone, emailили origin_user_id, могут принимать новые идентификаторы. Для этого вместо user_phone, emailили origin_user_id нужно передать два параметра в запросе:
- identification — название идентификатора;
- lookup — значение идентификатора.
Чтобы использовать эту функциональность, необходимо отправить запрос на регистрацию нового идентификатора клиента на почту [email protected] и дождаться его добавления.
Разновидности запросов с разными идентификаторами
curl --request POST \
--url https://sailplay.ru/api/v2/users/tags/add/ \
--header 'Accept: application/json' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data token=d21a23d5ff695377ca99a3a6cf9b4a1ec6452b00 \
--data store_department_id=14864 \
--data user_phone= 79653215476 \
--data 'tags=Tag1'
curl --request POST \
--url https://sailplay.ru/api/v2/users/tags/add/ \
--header 'Accept: application/json' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data token=d21a23d5f2295377ca99a3a6cf9b4a1ec6452b00 \
--data store_department_id=14864 \
--data email= [email protected] \
--data 'tags=Tag1,Tag2,Tag3'
curl --request POST \
--url https://sailplay.ru/api/v2/users/tags/add/ \
--header 'Accept: application/json' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data token=d21a23d5ff6953722a99a3a6cf9b4a1ec6452b00 \
--data store_department_id=14864 \
--data origin_user_id= uid23 \
--data 'tags=Tag1,Tag2,Tag3'
curl --request POST \
--url https://sailplay.ru/api/v2/users/tags/add/ \
--header 'Accept: application/json' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data token=d21a23d5ff695227ca99a3a6cf9b4a1ec6452b00 \
--data store_department_id=14864 \
--data identification=client_id_name \
--data lookup=client_id_value \
--data 'tags=Tag1'