Групповое получение краткой информации о фирмаx по email [1.2]

Описание

Получение краткой информации о других фирмах по email . 

Структура URL

HTTP метод: POST, ресурс: <base_url>/firms/search/summaries-emails

Результат

Коллекция структур "Краткая информация о фирме"

Светофор

Для пользователей, оплативших лицензию "Светофор", доступна информация по следующим полям структуры "Краткая информация о фирме": tf_firm_color, tf_account_color.

Для платных пользователей АТИ доступно поле affiliated_firms.

Пример запроса и ответа

Запрос

POST http://api.ati.su/v1.2/firms/search/summaries-emails

["testmail@mail.ru", "test@yandex.ru"]

Ответ

Ответ в формате JSON

 

[
    {
        "key": "testmail@mail.ru",
        "value":  [{
                     "ati_id": "123456",
                     "full_name": "Фирма 1, ИП",
                     "firm_type": "Экспедитор-перевозчик",
                     "info_reference": "http://ati.su/firms/123456/info",
                     "passport_reference": "http://ati.su/firms/123456/passport",
                     "city": "Санкт-Петербург",
                     "score": 5,
                     "claims_count" : 0,
                     "recommendations_count" : 1,
                     "bad_partner_mentions_count": 0,
                     "inn": 1234567890,
                     "ogrn": null,
	                 "negative_points_sum": 0,
    				 "tf_firm_color": "Red",
    				 "tf_account_color": "Yellow",
    				 "affiliated_firms": [        
						{
            				"firm_name": "Связанная фирма 1",
           					"inn": "111113333333",
            				"tf_firm_color": "Red",
            				"tf_has_signals": true
        				},
        				{
            				"firm_name": "Связанная фирма 2",
            				"inn": "1111111133333",
            				"tf_firm_color": "Yellow",
            				"tf_has_signals": true
        								}],
    				 "tf_has_signals": true,
    				 "registration_date": "2005-06-06T08:45:27.647Z",
    				 "contact_info_changed": "2018-02-28T12:51:13.76Z",
    				 "last_month_active_days": 25
                  }]
   },
   {     
        "key": "test@yandex.ru",
        "value":  [{
                     "ati_id": "654321",
                     "full_name": "Фирма 2, ИП",
                     "firm_type": "Перевозчик",
                     "info_reference": "http://ati.su/firms/654321/info",
                     "passport_reference": "http://ati.su/firms/654321/passport",
                     "city": "Санкт-Петербург",
                     "score": 4,
                     "claims_count" : 0,
                     "recommendations_count" : 1,
                     "bad_partner_mentions_count": 0,
                     "inn": 0987654321,
                     "ogrn": null,
	                 "negative_points_sum": 0,
    				 "tf_firm_color": "Red",
    				 "tf_account_color": "Yellow",
    				 "affiliated_firms": [],
    				 "tf_has_signals": true,
    				 "registration_date": "2005-06-06T08:45:27.647Z",
    				 "contact_info_changed": "2018-02-28T12:51:13.76Z",
    				 "last_month_active_days": 25
                   }]
 }
]

Список ответов сервера

HTTP код ответа
Код ошибки
Сообщение
200--Операция завершена успешно
404--Не найдено ни одного контакта, у которого указан запрашиваемый email
400invalid_input_dataОшибка валидации
401--Требуется авторизация
403forbiddenПревышен лимит запросов запросов на получение краткой информации фирмы по email