Бесплатная CRM система онлайн

Документация API

PHP SDK

Для работы с API в PHP существует готовый клиент, скачать который вы можете по ссылке https://github.com/rcheru/lovecrm-api-php

Авторизация

Для авторизации по API в заголовках запроса передается ключ API и секретный ключ, которые можно получить в личном кабинете -> раздел настройки -> API.

Укажите при вызове
  • Content-Type: application/json.
  • 039c1953b52fe5345d6b1ea174e7d233 — Ключ API(Token).
  • 23e67627f24a52a2ab1aa82da7ea5446 — секретный ключ.
  • Тело запроса передавайте в кодировке UTF-8.

Проверка статуса подключения

Тип запросаАдрес
GEThttps://love-crm.ru/api/v1/check/status

Пример запроса:

 curl -X POST \
-H "Content-Type: application/json" \
-H "X-Authorization: Token 039c1953b52fe5345d6b1ea174e7d233" \
-H "X-Secret: 23e67627f24a52a2ab1aa82da7ea5446" \
https://love-crm.ru/api/v1/check/status
var url = "https://love-crm.ru/api/v1/check/status"; 
var token = "039c1953b52fe5345d6b1ea174e7d233";
var secret = "23e67627f24a52a2ab1aa82da7ea5446";

var query = {};

var options = {
method: "POST",
mode: "cors",
headers: {
"Content-Type": "application/json",
"Authorization": "Token " + token,
"X-Secret": secret
},
body: JSON.stringify(query)
} fetch(url, options)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log("error", error));
// Check Status API 
$token = "a25bea39750a33cf765c46b920841911";
$secret = "2dfb56554df7bf396e58acc7b07fcf22";

$lovecrm = new \LoveCrm\LoveCrmClient($token, $secret);

/**
* @return json $response
*/
$response = $lovecrm->checkStatus();

print_r($response); // {"code":200,"message":"Connect success"}
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://love-crm.ru/api/v1/check/status');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$headers = array();
$headers[] = 'Content-Type: application/json';
$headers[] = 'X-Authorization: Token 039c1953b52fe5345d6b1ea174e7d233';
$headers[] = 'X-Secret: 23e67627f24a52a2ab1aa82da7ea5446';
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$result = curl_exec($ch);
if (curl_errno($ch)) { echo 'Error:' . curl_error($ch);
}
curl_close($ch);

Описание полей ответа:
Ответ возвращается в формате JSON
ПеременнаяТип поляОписание
codeintКоды ответа на запрос
messagestringСообщение о статусе выполнения запроса

Получить список статусов сделки

Тип запросаАдрес
GEThttps://love-crm.ru/api/v1/deals/getstatuses

Пример запроса:

 curl -X POST \
-H "Content-Type: application/json" \
-H "X-Authorization: Token 039c1953b52fe5345d6b1ea174e7d233" \
-H "X-Secret: 23e67627f24a52a2ab1aa82da7ea5446" \
https://love-crm.ru/api/v1/deals/getstatuses
var url = "https://love-crm.ru/api/v1/deals/getstatuses"; 
var token = "039c1953b52fe5345d6b1ea174e7d233";
var secret = "23e67627f24a52a2ab1aa82da7ea5446";

var query = {};

var options = {
method: "POST",
mode: "cors",
headers: {
"Content-Type": "application/json",
"Authorization": "Token " + token,
"X-Secret": secret
},
body: JSON.stringify(query)
} fetch(url, options)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log("error", error));
// Get Deal Statuses
$token = "a25bea39750a33cf765c46b920841911";
$secret = "2dfb56554df7bf396e58acc7b07fcf22";

$lovecrm = new \LoveCrm\LoveCrmClient($token, $secret);

/**
* @return json $response
*/
$response = $lovecrm->dealsStatuses();

print_r($response);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://love-crm.ru/api/v1/deals/getstatuses');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$headers = array();
$headers[] = 'Content-Type: application/json';
$headers[] = 'X-Authorization: Token 039c1953b52fe5345d6b1ea174e7d233';
$headers[] = 'X-Secret: 23e67627f24a52a2ab1aa82da7ea5446';
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$result = curl_exec($ch);
if (curl_errno($ch)) { echo 'Error:' . curl_error($ch);
}
curl_close($ch);

Описание полей ответа:
Ответ возвращается в формате JSON
ПеременнаяТип поляОписание
idintID статуса сделки
namestringНавзание статуса сделки
posintПозиция в воронке(сортировка)
closetintФлаг 1 - знаичт данный статус является закрывающим сделку(сделка успешно исполнена)

Получить список источников сделки

Тип запросаАдрес
GEThttps://love-crm.ru/api/v1/deals/getorigins

Пример запроса:

 curl -X POST \
-H "Content-Type: application/json" \
-H "X-Authorization: Token 039c1953b52fe5345d6b1ea174e7d233" \
-H "X-Secret: 23e67627f24a52a2ab1aa82da7ea5446" \
https://love-crm.ru/api/v1/deals/getorigins
var url = "https://love-crm.ru/api/v1/deals/getorigins"; 
var token = "039c1953b52fe5345d6b1ea174e7d233";
var secret = "23e67627f24a52a2ab1aa82da7ea5446";

var query = {};

var options = {
method: "POST",
mode: "cors",
headers: {
"Content-Type": "application/json",
"Authorization": "Token " + token,
"X-Secret": secret
},
body: JSON.stringify(query)
} fetch(url, options)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log("error", error));
// Get Deal Origins
$token = "a25bea39750a33cf765c46b920841911";
$secret = "2dfb56554df7bf396e58acc7b07fcf22";

$lovecrm = new \LoveCrm\LoveCrmClient($token, $secret);

/**
* @return json $response
*/
$response = $lovecrm->dealsOrigins();

print_r($response);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://love-crm.ru/api/v1/deals/getorigins');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$headers = array();
$headers[] = 'Content-Type: application/json';
$headers[] = 'X-Authorization: Token 039c1953b52fe5345d6b1ea174e7d233';
$headers[] = 'X-Secret: 23e67627f24a52a2ab1aa82da7ea5446';
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$result = curl_exec($ch);
if (curl_errno($ch)) { echo 'Error:' . curl_error($ch);
}
curl_close($ch);

Описание полей ответа:
Ответ возвращается в формате JSON
ПеременнаяТип поляОписание
idintID источника сделки
namestringНавзание источника сделки
textintОписание источника сделки

Получить список категорий сделки

Тип запросаАдрес
GEThttps://love-crm.ru/api/v1/deals/getcategories

Пример запроса:

 curl -X POST \
-H "Content-Type: application/json" \
-H "X-Authorization: Token 039c1953b52fe5345d6b1ea174e7d233" \
-H "X-Secret: 23e67627f24a52a2ab1aa82da7ea5446" \
https://love-crm.ru/api/v1/deals/getcategories
var url = "https://love-crm.ru/api/v1/deals/getcategories"; 
var token = "039c1953b52fe5345d6b1ea174e7d233";
var secret = "23e67627f24a52a2ab1aa82da7ea5446";

var query = {};

var options = {
method: "POST",
mode: "cors",
headers: {
"Content-Type": "application/json",
"Authorization": "Token " + token,
"X-Secret": secret
},
body: JSON.stringify(query)
} fetch(url, options)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log("error", error));
// Get Deal Categories
$token = "a25bea39750a33cf765c46b920841911";
$secret = "2dfb56554df7bf396e58acc7b07fcf22";

$lovecrm = new \LoveCrm\LoveCrmClient($token, $secret);

/**
* @return json $response
*/
$response = $lovecrm->dealsCategories();

print_r($response);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://love-crm.ru/api/v1/deals/getcategories');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$headers = array();
$headers[] = 'Content-Type: application/json';
$headers[] = 'X-Authorization: Token 039c1953b52fe5345d6b1ea174e7d233';
$headers[] = 'X-Secret: 23e67627f24a52a2ab1aa82da7ea5446';
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$result = curl_exec($ch);
if (curl_errno($ch)) { echo 'Error:' . curl_error($ch);
}
curl_close($ch);

Описание полей ответа:
Ответ возвращается в формате JSON
ПеременнаяТип поляОписание
idintID категории сделки
namestringНавзание категории сделки
textintОписание категории сделки

Получить данные сделки

Тип запросаАдрес
GEThttps://love-crm.ru/api/v1/deals/get

Пример запроса:

 curl -X POST \
-H "Content-Type: application/json" \
-H "X-Authorization: Token 039c1953b52fe5345d6b1ea174e7d233" \
-H "X-Secret: 23e67627f24a52a2ab1aa82da7ea5446" \
-d '{"id":"123"}' \
https://love-crm.ru/api/v1/deals/get
var url = "https://love-crm.ru/api/v1/deals/get"; 
var token = "039c1953b52fe5345d6b1ea174e7d233";
var secret = "23e67627f24a52a2ab1aa82da7ea5446";

var query = {"id": 123};

var options = {
method: "POST",
mode: "cors",
headers: {
"Content-Type": "application/json",
"Authorization": "Token " + token,
"X-Secret": secret
},
body: JSON.stringify(query)
} fetch(url, options)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log("error", error));
// Get Deal Categories
$token = "a25bea39750a33cf765c46b920841911";
$secret = "2dfb56554df7bf396e58acc7b07fcf22";

$lovecrm = new \LoveCrm\LoveCrmClient($token, $secret);

/**
* @return json $response
*/
$response = $lovecrm->getDeal([
'id' => '123', // ID deal (required field)
]);
print_r($response);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://love-crm.ru/api/v1/deals/get');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, "{\"id\":\"123\"}");
$headers = array();
$headers[] = 'Content-Type: application/json';
$headers[] = 'X-Authorization: Token 039c1953b52fe5345d6b1ea174e7d233';
$headers[] = 'X-Secret: 23e67627f24a52a2ab1aa82da7ea5446';
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$result = curl_exec($ch);
if (curl_errno($ch)) { echo 'Error:' . curl_error($ch);
}
curl_close($ch);
Описание полей запроса:
ПеременнаяТип поляОписаниеОбязательное
idintID сделкиДа

Описание полей ответа:
Ответ возвращается в формате JSON
ПеременнаяТип поляОписание
id_dealintID сделки
dateintДата в формате UNIX
namestringНазвание сделки
pricefloatСумма стоимости сделки
id_catintID категории (можно получить в ЛК -> Категории сделок -> Редактировать категорию)
id_statusintID статуса(шага воронки) сделки (можно получить в ЛК -> Статусы сделок -> Редактировать статус)
id_originintID источника (можно получить в ЛК -> Источники сделок -> Редактировать источник)
id_clientintID клиента (можно получить в ЛК -> Клиенты -> Редактировать клиента)
archivebooleanПереместить сделку в архив
tagsstringТеги через запятую
colorstringЦвет сделки на доске Канбан в формате HEX, пример: AD3939
textstringОписание сделки

Добавление сделки

Тип запросаАдрес
POSThttps://love-crm.ru/api/v1/deals/add

Пример запроса:

 curl -X POST \
-H "Content-Type: application/json" \
-H "X-Authorization: Token 039c1953b52fe5345d6b1ea174e7d233" \
-H "X-Secret: 23e67627f24a52a2ab1aa82da7ea5446" \
-d '{"name":"Deal Name","price":0,"id_cat":0,"id_status":0,"id_origin":0,"id_client":0,"archive":false,"tags":"","color":"","text":""}' \
https://love-crm.ru/api/v1/deals/add
var url = "https://love-crm.ru/api/v1/deals/add"; 
var token = "039c1953b52fe5345d6b1ea174e7d233";
var secret = "23e67627f24a52a2ab1aa82da7ea5446";

var query = {
"name":"Deal Name",
"price":0,
"id_cat":0,
"id_status":0,
"id_origin":0,
"id_client":0,
"archive":false,
"tags":"",
"color":"",
"text":""
};

var options = {
method: "POST",
mode: "cors",
headers: {
"Content-Type": "application/json",
"Authorization": "Token " + token,
"X-Secret": secret
},
body: JSON.stringify(query)
} fetch(url, options)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log("error", error));
// Add Deal 
$token = "a25bea39750a33cf765c46b920841911";
$secret = "2dfb56554df7bf396e58acc7b07fcf22";

$lovecrm = new \LoveCrm\LoveCrmClient($token, $secret);

/**
* @return json $response
*/
$response = $lovecrm->addDeal([
'name' => 'Тестовая сделка', // Name deal (required field)
'price' => 0.0, // Price deal (optional)
'id_cat' => 0, // Category ID (optional)
'id_status' => 0, // Status deal ID (optional)
'id_origin' => 0, // Origin ID (optional)
'id_client' => 0, // Client ID (optional)
'archive' => false, // Moving a Deal to the archive (optional)
'tags' => '', // Tags separated by commas (optional)
'color' => '', // Color Deal in HEX, example: AD3939 (optional)
'text' => '', // Text detail description Deal (optional)
]);

print_r($response); // {"code":200,"message":"Deal added successfully","id_deal":"24"}
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://love-crm.ru/api/v1/deals/add');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, "{\"name\":\"Deal Name\",\"price\":0,\"id_cat\":0,\"id_status\":0,\"id_origin\":0,\"id_client\":0,\"archive\":false,\"tags\":\"\",\"color\":\"\",\"text\":\"\"}");
$headers = array();
$headers[] = 'Content-Type: application/json';
$headers[] = 'X-Authorization: Token 039c1953b52fe5345d6b1ea174e7d233';
$headers[] = 'X-Secret: 23e67627f24a52a2ab1aa82da7ea5446';
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$result = curl_exec($ch);
if (curl_errno($ch)) { echo 'Error:' . curl_error($ch);
}
curl_close($ch);
Описание полей запроса:
ПеременнаяТип поляОписаниеОбязательное
namestringНазвание сделкиДа
pricefloatСумма стоимости сделкиНет
id_catintID категории (можно получить в ЛК -> Категории сделок -> Редактировать категорию)Нет
id_statusintID статуса(шага воронки) сделки (можно получить в ЛК -> Статусы сделок -> Редактировать статус)Нет
id_originintID источника (можно получить в ЛК -> Источники сделок -> Редактировать источник)Нет
id_clientintID клиента (можно получить в ЛК -> Клиенты -> Редактировать клиента)Нет
archivebooleanПереместить сделку в архив Нет
tagsstringТеги через запятуюНет
colorstringЦвет сделки на доске Канбан в формате HEX, пример: AD3939Нет
textstringОписание сделкиНет

Описание полей ответа:
Ответ возвращается в формате JSON
ПеременнаяТип поляОписание
codeintКоды ответа на запрос
messagestringСообщение о статусе выполнения запроса
id_dealintID добавленной сделки

Обновление сделки

Тип запросаАдрес
POSThttps://love-crm.ru/api/v1/deals/update

Пример запроса:

 curl -X POST \
-H "Content-Type: application/json" \
-H "X-Authorization: Token 039c1953b52fe5345d6b1ea174e7d233" \
-H "X-Secret: 23e67627f24a52a2ab1aa82da7ea5446" \
-d '{"id_deal":123,"name":"Deal Name","price":0,"id_cat":0,"id_status":0,"id_origin":0,"id_client":0,"archive":false,"tags":"","color":"","text":""}' \
https://love-crm.ru/api/v1/deals/update
var url = "https://love-crm.ru/api/v1/deals/update"; 
var token = "039c1953b52fe5345d6b1ea174e7d233";
var secret = "23e67627f24a52a2ab1aa82da7ea5446";

var query = {
"id_deal":123,
"name":"Deal Name",
"price":0,
"id_cat":0,
"id_status":0,
"id_origin":0,
"id_client":0,
"archive":false,
"tags":"",
"color":"",
"text":""
};

var options = {
method: "POST",
mode: "cors",
headers: {
"Content-Type": "application/json",
"Authorization": "Token " + token,
"X-Secret": secret
},
body: JSON.stringify(query)
} fetch(url, options)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log("error", error));
// Add Deal 
$token = "a25bea39750a33cf765c46b920841911";
$secret = "2dfb56554df7bf396e58acc7b07fcf22";

$lovecrm = new \LoveCrm\LoveCrmClient($token, $secret);

/**
* @return json $response
*/
$response = $lovecrm->updateDeal([
'id_deal' => 123, // ID Deal for Update
'name' => 'Тестовая сделка', // Name deal (required field)
'price' => 0.0, // Price deal (optional)
'id_cat' => 0, // Category ID (optional)
'id_status' => 0, // Status deal ID (optional)
'id_origin' => 0, // Origin ID (optional)
'id_client' => 0, // Client ID (optional)
'archive' => false, // Moving a Deal to the archive (optional)
'tags' => '', // Tags separated by commas (optional)
'color' => '', // Color Deal in HEX, example: AD3939 (optional)
'text' => '', // Text detail description Deal (optional)
]);

print_r($response); // {"code":200,"message":"Deal updated successfully","id_deal":"24"}
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://love-crm.ru/api/v1/deals/update');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, "{\"id_deal\":\"123\",\"name\":\"Deal Name\",\"price\":0,\"id_cat\":0,\"id_status\":0,\"id_origin\":0,\"id_client\":0,\"archive\":false,\"tags\":\"\",\"color\":\"\",\"text\":\"\"}");
$headers = array();
$headers[] = 'Content-Type: application/json';
$headers[] = 'X-Authorization: Token 039c1953b52fe5345d6b1ea174e7d233';
$headers[] = 'X-Secret: 23e67627f24a52a2ab1aa82da7ea5446';
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$result = curl_exec($ch);
if (curl_errno($ch)) { echo 'Error:' . curl_error($ch);
}
curl_close($ch);
Описание полей запроса:
ПеременнаяТип поляОписаниеОбязательное
id_dealintID сделки которую следует обновитьДа
namestringНазвание сделкиНет
pricefloatСумма стоимости сделкиНет
id_catintID категории (можно получить в ЛК -> Категории сделок -> Редактировать категорию)Нет
id_statusintID статуса(шага воронки) сделки (можно получить в ЛК -> Статусы сделок -> Редактировать статус)Нет
id_originintID источника (можно получить в ЛК -> Источники сделок -> Редактировать источник)Нет
id_clientintID клиента (можно получить в ЛК -> Клиенты -> Редактировать клиента)Нет
archivebooleanПереместить сделку в архив Нет
tagsstringТеги через запятуюНет
colorstringЦвет сделки на доске Канбан в формате HEX, пример: AD3939Нет
textstringОписание сделкиНет

Описание полей ответа:
Ответ возвращается в формате JSON
ПеременнаяТип поляОписание
codeintКоды ответа на запрос
messagestringСообщение о статусе выполнения запроса
id_dealintID обновленной сделки

Добавление задачи

Тип запросаАдрес
POSThttps://love-crm.ru/api/v1/tasks/add

Пример запроса:

 curl -X POST \
-H "Content-Type: application/json" \
-H "X-Authorization: Token 039c1953b52fe5345d6b1ea174e7d233" \
-H "X-Secret: 23e67627f24a52a2ab1aa82da7ea5446" \
-d '{"name":"Task Name","date_from":"","date_to":"","all_day":false,"color":"","text":"","id_deal":0,"id_status":0,"id_type":0}' \
https://love-crm.ru/api/v1/tasks/add
var url = "https://love-crm.ru/api/v1/tasks/add"; 
var token = "039c1953b52fe5345d6b1ea174e7d233";
var secret = "23e67627f24a52a2ab1aa82da7ea5446";

var query = {
"name":"Task Name",
"date_from":"",
"date_to":"",
"all_day":false,
"color":"",
"text":"",
"id_deal":0,
"id_status":0,
"id_type":0
};

var options = {
method: "POST",
mode: "cors",
headers: {
"Content-Type": "application/json",
"Authorization": "Token " + token,
"X-Secret": secret
},
body: JSON.stringify(query)
} fetch(url, options)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log("error", error));
// Add Task
$token = "a25bea39750a33cf765c46b920841911";
$secret = "2dfb56554df7bf396e58acc7b07fcf22";

$lovecrm = new \LoveCrm\LoveCrmClient($token, $secret);

/**
* @return json $response
*/
$response = $lovecrm->addTask([
'name' => 'Тестовая задача', // Name Task (required field)
'date_from' => '', // Task start Date-time, example: 2022-05-28T15:00:00 (required field)
'date_to' => '', // Task end Date-time, example: 2022-05-28T17:00:00 (required field)
'all_day' => false, // All day duration (optional)
'color' => '', // Color Task in HEX, example: AD3939 (optional)
'text' => '', // Text detail description Task (optional)
'id_deal' => 0, // Deal ID (optional)
'id_status' => 0, // Status task ID (optional)
'id_type' => 0, // Task type ID (optional)
]);

print_r($response); // {"code":200,"message":"Task added successfully","id_task":"75"}
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://love-crm.ru/api/v1/tasks/add');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, "{\"name\":\"Task Name\",\"date_from\":\"\",\"date_to\":\"\",\"all_day\":false,\"color\":\"\",\"text\":\"\",\"id_deal\":0,\"id_status\":0,\"id_type\":0}");
$headers = array();
$headers[] = 'Content-Type: application/json';
$headers[] = 'X-Authorization: Token 039c1953b52fe5345d6b1ea174e7d233';
$headers[] = 'X-Secret: 23e67627f24a52a2ab1aa82da7ea5446';
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$result = curl_exec($ch);
if (curl_errno($ch)) { echo 'Error:' . curl_error($ch);
}
curl_close($ch);
Описание полей запроса:
ПеременнаяТип поляОписаниеОбязательное
namestringНазвание задачиДа
date_fromstringДата и время начала задачи, пример: 2022-05-28T15:00:00Да
date_tostringДата и время окончания задачи, пример: 2022-05-28T17:00:00Да
all_daybooleanУстановить задачу, как задачу периодом на весь деньНет
colorstringЦвет задачи на доске Канбан/Календаре в формате HEX, пример: AD3939Нет
textstringОписание задачиНет
id_dealintID сделки (можно получить в ЛК -> Сделки -> Редактировать сделки)Нет
id_statusintID статуса задачи (можно получить в ЛК -> Статусы задач -> Редактировать статус)Нет
id_typeintID типа задачи (можно получить в ЛК -> Типы задач -> Редактировать тип задачи)Нет

Описание полей ответа:
Ответ возвращается в формате JSON
ПеременнаяТип поляОписание
codeintКоды ответа на запрос
messagestringСообщение о статусе выполнения запроса
id_taskintID добавленной задачи

Получить список статусов клиента

Тип запросаАдрес
GEThttps://love-crm.ru/api/v1/clients/getstatuses

Пример запроса:

 curl -X POST \
-H "Content-Type: application/json" \
-H "X-Authorization: Token 039c1953b52fe5345d6b1ea174e7d233" \
-H "X-Secret: 23e67627f24a52a2ab1aa82da7ea5446" \
https://love-crm.ru/api/v1/clients/getstatuses
var url = "https://love-crm.ru/api/v1/clients/getstatuses"; 
var token = "039c1953b52fe5345d6b1ea174e7d233";
var secret = "23e67627f24a52a2ab1aa82da7ea5446";

var query = {};

var options = {
method: "POST",
mode: "cors",
headers: {
"Content-Type": "application/json",
"Authorization": "Token " + token,
"X-Secret": secret
},
body: JSON.stringify(query)
} fetch(url, options)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log("error", error));
// Get Deal Statuses
$token = "a25bea39750a33cf765c46b920841911";
$secret = "2dfb56554df7bf396e58acc7b07fcf22";

$lovecrm = new \LoveCrm\LoveCrmClient($token, $secret);

/**
* @return json $response
*/
$response = $lovecrm->clientsStatuses();

print_r($response);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://love-crm.ru/api/v1/clients/getstatuses');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$headers = array();
$headers[] = 'Content-Type: application/json';
$headers[] = 'X-Authorization: Token 039c1953b52fe5345d6b1ea174e7d233';
$headers[] = 'X-Secret: 23e67627f24a52a2ab1aa82da7ea5446';
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$result = curl_exec($ch);
if (curl_errno($ch)) { echo 'Error:' . curl_error($ch);
}
curl_close($ch);

Описание полей ответа:
Ответ возвращается в формате JSON
ПеременнаяТип поляОписание
idintID статуса клиента
namestringНавзание статуса клиента
posintПозиция в сортировка

Получить данные клиента

Тип запросаАдрес
GEThttps://love-crm.ru/api/v1/clients/get

Пример запроса:

 curl -X POST \
-H "Content-Type: application/json" \
-H "X-Authorization: Token 039c1953b52fe5345d6b1ea174e7d233" \
-H "X-Secret: 23e67627f24a52a2ab1aa82da7ea5446" \
-d '{"id":"123"}' \
https://love-crm.ru/api/v1/clients/get
var url = "https://love-crm.ru/api/v1/clients/get"; 
var token = "039c1953b52fe5345d6b1ea174e7d233";
var secret = "23e67627f24a52a2ab1aa82da7ea5446";

var query = {"id": 123};

var options = {
method: "POST",
mode: "cors",
headers: {
"Content-Type": "application/json",
"Authorization": "Token " + token,
"X-Secret": secret
},
body: JSON.stringify(query)
} fetch(url, options)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log("error", error));
// Get Deal Categories
$token = "a25bea39750a33cf765c46b920841911";
$secret = "2dfb56554df7bf396e58acc7b07fcf22";

$lovecrm = new \LoveCrm\LoveCrmClient($token, $secret);

/**
* @return json $response
*/
$response = $lovecrm->getClient([
'id' => '123', // ID deal (required field)
]);
print_r($response);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://love-crm.ru/api/v1/clients/get');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, "{\"id\":\"123\"}");
$headers = array();
$headers[] = 'Content-Type: application/json';
$headers[] = 'X-Authorization: Token 039c1953b52fe5345d6b1ea174e7d233';
$headers[] = 'X-Secret: 23e67627f24a52a2ab1aa82da7ea5446';
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$result = curl_exec($ch);
if (curl_errno($ch)) { echo 'Error:' . curl_error($ch);
}
curl_close($ch);
Описание полей запроса:
ПеременнаяТип поляОписаниеОбязательное
idintID клиентаДа

Описание полей ответа:
Ответ возвращается в формате JSON
ПеременнаяТип поляОписание
id_clientintID клиента
dateintДата в формате UNIX
namestringИмя клиента
emailfloatE-mail клиента
phoneintТелефон клиента
id_statusintID статуса клиента (можно получить в ЛК -> Статусы клиентов -> Редактировать статус)

Добавление клиента

Тип запросаАдрес
POSThttps://love-crm.ru/api/v1/clients/add

Пример запроса:

 curl -X POST \
-H "Content-Type: application/json" \
-H "X-Authorization: Token 039c1953b52fe5345d6b1ea174e7d233" \
-H "X-Secret: 23e67627f24a52a2ab1aa82da7ea5446" \
-d '{"realname":"User Name","realnamefind":false,"email":"","emailfind":true,"phone":"","phonefind":true,"position":"","id_status":0,"text":"","fields":{"nameField":"valueField"}}' \
https://love-crm.ru/api/v1/clients/add
var url = "https://love-crm.ru/api/v1/clients/add";
var token = "039c1953b52fe5345d6b1ea174e7d233";
var secret = "23e67627f24a52a2ab1aa82da7ea5446";

var query = {
"realname":"User Name",
"realnamefind":false,
"email":"",
"emailfind":true,
"phone":"",
"phonefind":true,
"position":"",
"id_status":0,
"text":"",
"fields":{"nameField":"valueField"}
};

var options = {
method: "POST",
mode: "cors",
headers: {
"Content-Type": "application/json",
"Authorization": "Token " + token,
"X-Secret": secret
},
body: JSON.stringify(query)
}

fetch(url, options)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log("error", error));
// Add Task
$token = "a25bea39750a33cf765c46b920841911";
$secret = "2dfb56554df7bf396e58acc7b07fcf22";

$lovecrm = new \LoveCrm\LoveCrmClient($token, $secret);

/**
* @return json $response
*/
$response = $lovecrm->addClient([
'realname' => '(ТЕСТ)Иванов Иван Иванович', // Real name client (required field)
'realnamefind' => false, // Find a client by Name in my Datebase (optional, default = false)
'email' => '', // E-Mail client (optional)
'emailfind' => true, // Find a client by E-Mail in my Datebase (optional, default = false)
'phone' => '', // Phone client ID (optional)
'phonefind' => true, // Find a client by Phone in my Datebase (optional, default = false)
'position' => '', // Position(job title) client ID (optional)
'id_status' => 0, // Status client ID (optional)
'text' => '', // Text detail description Client (optional)
'fields' => [ // Array addition fields (optional)
'nameField' => 'valueField',
]
]);

print_r($response); // {"code":200,"message":"Client added successfully","id_client":"101"}
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://love-crm.ru/api/v1/clients/add');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, "{\"realname\":\"User Name\",\"realnamefind\":false,\"email\":\"\",\"emailfind\":true,\"phone\":\"\",\"phonefind\":true,\"position\":\"\",\"id_status\":0,\"text\":\"\",\"fields\":{\"nameField\":\"valueField\"}}");
$headers = array();
$headers[] = 'Content-Type: application/json';
$headers[] = 'X-Authorization: Token 039c1953b52fe5345d6b1ea174e7d233';
$headers[] = 'X-Secret: 23e67627f24a52a2ab1aa82da7ea5446';
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$result = curl_exec($ch);
if (curl_errno($ch)) { echo 'Error:' . curl_error($ch);
}
curl_close($ch);
Описание полей запроса:
ПеременнаяТип поляОписаниеОбязательное
realnamestringФИО клиентаДа
realnamefindbooleanПоиск клиента в базе данных пользователя по ФИО (по умолчанию = false, не искать)Нет
emailstringE-Mail клиентаНет
emailfindbooleanПоиск клиента в базе данных пользователя по E-Mail (по умолчанию = false, не искать)Нет
phonestringТелефон клиентаНет
phonefindbooleanПоиск клиента в базе данных пользователя по Телефону (по умолчанию = false, не искать)Нет
positionstringДолжность клиентаНет
id_statusintID статуса клиента (можно получить в ЛК -> Статусы клиентов -> Редактировать статус клиента)Нет
textstringОписание клиентаНет
fieldsarray assocАссоциативный массив с дополнительными полями, содежащими информацию по клиенту, где ключ - имя поля, значение - данныеНет

Описание полей ответа:
Ответ возвращается в формате JSON
ПеременнаяТип поляОписание
codeintКоды ответа на запрос
messagestringСообщение о статусе выполнения запроса
id_clientintID добавленного клиента

Коды ответов

КодОписание
200Success - Запрос выполнен успешно
400Bad Request - Запрос содержит неверные данные
401Unauthorized - Неавторизован. Неверно передан Секретный или API ключ
403Forbidden - Запрещено. Передан не действующий Секретный или API ключ
501Not Implemented - Не реализован (Метод API не существует)