Перейти к содержанию

Клиенты

Клиенты связаны с подписками. Они могут быть созданы либо вместе с подпиской через API подписки, либо через API следующим образом (смотрите ниже).


Создание клиента

Отправьте POST запрос на https://api.ecomcharge.com/customers со следующими параметрами:

Параметр Тип Описание
first_name string Имя клиента.
last_name string Фамилия клиента.
address string Адрес клиента.
city string Город клиента.
country string Страна клиента в ISO 3166-1 alpha-2 формате.
zip string Почтовый индекс клиента. Для country=US, формат почтового индекса должен иметь вид NNNNN или NNNNN-NNNN
state string Штат / область / регион клиента (состоит из двух букв), только если страна адреса для выставления счёта US или CA
phone string Номер телефона клиента.
email * обязательный
string Адрес электронной почты клиента.
ip * обязательный
string IP-адрес устройства клиента.

Если права доступа и параметры верны, eComCharge вернет 201 код состояния HTTP и данные нового клиента. Иначе, eComCharge вернет 422 код состояния HTTP и сообщение об ошибке.

Пример верного запроса на создание клиента
curl https://api.ecomcharge.com/customers \
  -X POST -u shop_id:secret_key \
  -H "Content-Type: application/json" \
  -d \
'{
  "first_name":"John",
  "last_name":"Doe",
  "address":"1st Street",
  "country":"US",
  "city":"Denver",
  "zip":"92006",
  "state":"CO",
  "phone":"+1-555-555-5555",
  "email":"customer@example.com",
  "ip":"127.0.0.1"
}'
Пример ответа на запрос на создание клиента
{
  "id":"cst_7aee5afb954c7ef7",
  "first_name":"John",
  "last_name":"Doe",
  "address":"1st Street",
  "country":"US",
  "city":"Denver",
  "zip":"92006",
  "state":"CO",
  "phone":"+1-555-555-5555",
  "email":"customer@example.com",
  "ip":"127.0.0.1"
}
Пример запроса создания клиента, когда параметр неверен или не передан
curl https://api.ecomcharge.com/customers \
  -X POST -u shop_id:secret_key \
  -H "Content-Type: application/json" \
  -d \
'{
  "city":"Denver",
  "zip":"92006",
  "state":"CO",
  "phone":"+1-555-555-5555",
  "email":"customer@example.com"
}'
Пример ответа на запрос создания клиента, когда параметр неверен или не передан
{
  "message": "Ip address is invalid. Ip can't be blank",
  "errors": {
    "ip": [
      "address is invalid",
      "can't be blank"
    ]
  }
}

Просмотр информации о клиенте

Для просмотра информации о клиентах отправьте GET запрос на https://api.ecomcharge.com/customers/:customer_id, где customer_id - идентификатор клиента.

Если клиент с таким ID существует, система вернет 200 код состояния и информацию о нем.

Пример запроса на информацию о клиенте с ID cst_7aee5afb954c7ef7 и ответа на него
curl -u shop_id:secret \
  https://api.ecomcharge.com/customers/cst_7aee5afb954c7ef7
Пример ответа
{
  "id":"cst_7aee5afb954c7ef7",
  "first_name":"John",
  "last_name":"Doe",
  "address":"1st Street",
  "country":"US",
  "city":"Denver",
  "zip":"92006",
  "state":"CO",
  "phone":"+1-555-555-5555",
  "email":"customer@example.com",
  "ip":"127.0.0.1"
}

Просмотр информации о всех клиентах

Для просмотра информации о списке всех клиентов отправьте GET запрос на https://api.ecomcharge.com/customers.

Если клиенты имеются, eComCharge вернет 200 код состояния и массив клиентов.

Пример запроса на получение списка клиентов
curl -u shop_id:secret \
  https://api.ecomcharge.com/customers
Пример ответа
[
  {"id":"cst_5ca4fab9dfc7fcbf","first_name":"John","last_name":"Doe","address":"1st Street","country":"US","city":"Denver","zip":"92006","state":"CO","phone":"+1-555-555-5555","email":"customer@example.com","ip":"127.0.0.1"},
  {"id":"cst_9f65045c1f4c3676","first_name":"Mark","last_name":"Dow","address":"2nd Street","country":"US","city":"Denver","zip":"90006","state":"CO","phone":"+1-551-548-5547","email":"customer.mark@example.com","ip":"10.10.0.4"}
]