Обязательные заголовки в запросе
Accept:application/json
Authorization: Bearer ваш_токен_авторизации.
Токен нужен для авторизации, без него API будет выдавать код ошибки и данные запросить будет невозможно.
Как получить токен?
Воспользуйтесь функцией авторизации пользователя API.
Получить данные по всем заявкам, кроме архивных
GET http://apis.estcrm.com/orders
Получить данные по конкретной заявке, по ее номеру (ID)
GET http://apis.estcrm.com/orders?search=id:100
Поиск заявок по конкретному полю (в примере ищем все заявки с операцией “продажа”)
GET http://apis.estcrm.com/orders?search=client_category:продажа
Поля, по которым можно искать:
id - номер заявки
tema - суть заявки
promo - рекламный текст
headline - рекламный заголовок
client_category - операция (продажа, покупка, сдать, снять)
object_city - город
street - улица
budzhet_do - цена в $
id_user_responsible - id ответственного по заявке
Формат выдачи данных - json. Пример выдачи и пояснение по полям.
{ "data": [ { "type": "order", "id": 428,// номер заявки "id_est": 11899107,// номер объявления на est.ua "tema": "<p>Продается ирехэтажный дом очень комфортный и уютный с эргономичной планировкой подходящей как для постоянного проживания, так и для отдыха.</p>\n<p>",// суть заявки "headline": "",// рекламный заголовок "promo": "",// рекламный текст "client_category": "продажа",// операция (продажа, покупка, сдать, снять) "status": "Эксклюзивный договор", "object_type": "Дом",// тип недвижимости "object_city": "",// город "district": "",// район города "street": "",// улица "num_house": "Виноградная",// номер дома "num_flat": "",// номер квартиры "segment": "",// сегмент рынка "market_type": "вторичный рынок",// тип рынка "rooms": 0,// кол-во комнат "rooms_to": 0,// комнат до - для заявки на покупку "is_free_plan": 0,// =1 если свободная планировка "area": "306.5",// общая площадь, м.кв "area_living": "190.0",// жилая площадь, м.кв. "area_land": "0.0",// площадь участка "condition": "евроремонт", "otoplenie": "не определено", "area_kitchen": "15.0",// площадь кухни "floor": 0,// этаж "floor_to": 0,// до какого этажа (для заявки на покупку) "floors": 0,// этажность "material_sten": "", "usd_price": 1200000, // сумма, пересчитанная в $ "user_price": 1200000, // сумма, как ее добавил пользователь "currency": "usd", // в какой валюте добавил пользователь "id_user_responsible": 27, //id ответственного "responsible_fio": "Ольга Довг", // ответственный "responsible_phone": "+79788704586", "conditions": "50% от комиссионных при совместной сделке, 10% от комиссионных за передачу заявки в работу.\r\nЗвоните - договоримся в любом случае.", "date_perform": "31-12-2017", // дата исполнения заявки "created_at": "05-01-2017 12:55",// дата создания "updated_at": "06-01-2017 08:50",// дата обновления "files": {// ссылки на фото "1": "http://demo.estcrm.com/files/files/r66d7ad0un42rjli0vzww6c6t0b8ou2i.jpg", "2": "http://demo.estcrm.com/files/files/t9csp9hw1twizrdq14i2d2hvahel1tbp.jpg", "3": "http://demo.estcrm.com/files/files/xlf8gwxm6gaf4fnww5r5nvc0nez7vhlx.jpg", }
} ] }
Пример кода на PHP
function getSOMOrder()
{
$return = null;
$url = 'http://apis.estcrm.com/orders?search=id:5';
$token = '...MjAwMywiZXhwIjoxNDg3MjkwMDAzLCJuYmYiOjE0ODQ2NjIwMDMsImp0aSI6IjIzMTJhY2YyNzE5ZDZkNTE3ZmZjMTY3...';
$curl = curl_init($url);
if ($curl) {
curl_setopt($curl,CURLOPT_RETURNTRANSFER,true);
curl_setopt($curl, CURLOPT_HTTPHEADER, array(
"Accept:application/json",
"Authorization: Bearer $token"
));
$page = curl_exec($curl);
curl_close($curl);
unset($curl);
$return = json_decode($page,true);
}
return $return;
}