Надежный и удобный способ для отправки / импорта клиентов – Platform API v4. Для работы с API рекомендуем использовать библиотеку Unirest.

Добавление

Для добавления клиента используйте HTTP метод POST. Ключ аутентификации можно посмотреть в личном кабинете.


Пример для Shell:

API_TOKEN=xxxxxxxxxxxx
curl -X POST -H "Content-Type: application/vnd.api+json" \
-H "Authorization: Token token=$API_TOKEN" \
--url http://api.aplaut.io/v4/consumers \
-d '{
"data": {
"type": "consumers",
"attributes": {
"external_id": "347771386",
"name": "Александр Лукашенко",
"email": "luka@president.by",
"custom_attributes": {
"orders_count": "12",
"ltv": "27456",
"region": "74"
}
}
}
}'

Пример для PHP:

<?php
//Install http://unirest.io/php.html

const API_TOKEN = "xxxxxxxxxxxx";

$headers = [
'Accept' => 'application/vnd.api+json',
'Content-Type' => 'application/vnd.api+json',
'Authorization' => "Token token=" . API_TOKEN
];

$parameters = [
"data" => [
"type"=> "consumers",
"attributes" => [
"external_id" => "347771386",
"name" => "Александр Лукашенко",
"email" => "luka@president.by",
"custom_attributes" => [
"orders_count" => "12",
"ltv" => "27456",
"region" => "74"
]
]
]
];

$response = Unirest\Request::post(
"https://api.aplaut.io/v4/consumers", $headers, $parameters);

$response->code; // HTTP Status code
?>

Пример для Ruby:

<?php
//Install http://unirest.io/php.html

const API_TOKEN = "xxxxxxxxxxxx";

$headers = [
'Accept' => 'application/vnd.api+json',
'Content-Type' => 'application/vnd.api+json',
'Authorization' => "Token token=" . API_TOKEN
];

$parameters = [
"data" => [
"type"=> "consumers",
"attributes" => [
"external_id" => "347771386",
"name" => "Александр Лукашенко",
"email" => "luka@president.by",
"custom_attributes" => [
"orders_count" => "12",
"ltv" => "27456",
"region" => "74"
]
]
]
];

$response = Unirest\Request::post(
"https://api.aplaut.io/v4/consumers", $headers, $parameters);

$response->code; // HTTP Status code
?>


Если попытаться создать клиента, который уже есть в БД Aplaut, то вернется результат с кодом ошибки 422.

Если вы не знаете наверняка, добавлен ли был ранее клиент, то используйте метод API для обновления (см. ниже). Подробнее читайте в документации к API.

Обновление

Для обновления клиента (например, статусов) используйте HTTP метод PUT.

Пример обновления статуса оплаты для ранее добавленного клиента:

Пример для Shell:

API_TOKEN=xxxxxxxxxxxx
curl -X PUT -H "Content-Type: application/vnd.api+json" \
-H "Authorization: Token token=$API_TOKEN" \
--url http://api.aplaut.io/v4/consumers/347771386 \
-d '{
"data": {
"type": "consumers",
"attributes": {
"custom_attributes": {
"ltv": '37456'
}
}
}
}'

Пример для PHP:

<?php
//Instal http://unirest.io/php.html

const API_TOKEN = "xxxxxxxxxxxx";

$headers = array(
'Accept' => 'application/vnd.api+json',
'Content-Type' => 'application/vnd.api+json',
'Authorization' => "Token token=" . API_TOKEN);

$parameters = [
"data" => [
"type"=> "consumers",
"attributes" => [
"custom_attributes" => [
"ltv" => "37456"
]
]
]
];

$response = Unirest\Request::put(
'https://api.aplaut.io/v4/consumers/347771386', $headers, $parameters);

$response->code; // HTTP Status code
?>

Пример для Ruby:

# gem install unirest

require 'unirest'

API_TOKEN = 'xxxxxxxxxxxx' # API Token

headers = {
'Accept': 'application/vnd.api+json',
'Content-Type': 'application/vnd.api+json',
'Authorization': "Token token=#{API_TOKEN}"
}
parameters = {
data: {
type: 'consumers',
attributes: {
custom_attributes: {
ltv: '37456'
}
}
}
}
response = Unirest.put 'https://api.aplaut.io/v4/consumers/347771386', headers, parameters

puts response.code

Если попытаться обновить клиента, которого нет в БД Aplaut, то будет создан новый клиент с external_id равным 347771386 (из примера). Подробнее читайте в документации к API.

Вы нашли ответ?