Импорт клиентов через API

Чтобы проводить опросы среди клиентов, их нужно сначала добавить в Aplaut. Удобный способ – API

Надежный и удобный способ для отправки / импорта клиентов – 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.

👆 На этом пока всё