- PHP версии 5.5+
- PHP-расширение cURL
Установка через composer
- Установить composer в проект:
curl -sS https://getcomposer.org/installer | php
- Добавить в зависимости пакет:
php composer.phar require helpim/api-client-php
- Подключить автозагрузку файлов классов:
require 'vendor/autoload.php';
Каждый запрос должен содержать идентификатор сервиса (customerServiceId), авторизационный токен (token) и набор данных, представляющий собой массив элементов.
- customers - наполнение справочника клиентов;
- nomenclature - наполнение справочника номенклатуры;
- orders - передача заказов в обработку;
- statuses - наполнение справочника статусов.
function sendOrder()
{
$defaultFields = [
'customerServiceId' => 123,
'token' => 'myLongSecureToken'
];
$api = new \Helpim\Api\Client\HttpClient($defaultFields);
$newOrder = [
'external' => [
'id' => 12345,
'number' => 'ABC12345'
],
'customer' => [
'fullName' => 'Иванов Иван',
'phoneNumber1' => '+7 999 123 4567'
]
];
try {
$response = $api->request([
'orders' => [
$newOrder
]
]);
} catch (\Helpim\Api\Exception\CurlException $e) {
printf('Error %d: %s', $e->getCode(), $e->getMessage());
return false;
}
if (!$response->isSuccessful()) {
printf('Error %d: %s: %s', $response->getStatusCode(), $response->getError(), $response->getMessage());
return false;
}
return true;
}