/v2/Api/LinkStatistics/{ID} GET
Возвращает статистику по ссылкам в указанном сообщении. Для каждой найденной ссылки запрос вернет общее количество кликов, количество уникальных кликов и так далее.
Формат запроса
Параметры запроса:
| Параметры | Тип | Описание |
|---|---|---|
| apiKey | string | Ваш API-key, необходимый для авторизации. Обязательный. |
| ID | int | ID сообщения. Обязательный. Является частью адреса, а не параметром. Смотрите примеры. |
| startDate | date | Необязательный. Оба параметра (startDate, endDate) нужны для указания периода статистики.Формат — YYYY-MM-DD |
| endDate | date | Смотрите startDate. |
Примеры:
https://api.esv2.com/v2/Api/LinkStatistics/123?apiKey=Ваш_API-ключ https://api.esv2.com/v2/Api/LinkStatistics/123?apiKey=Ваш_API-ключ&startDate=2010-05-20&endDate=2010-05-22
Ответ
Элементы тега Data в ответе:
| Элемент/атрибут | Тип | Описание |
|---|---|---|
| LinkStatistics | array[complex] | Массив элементов LinkStatistic. |
Элементы тега LinkStatistic:
| Элемент/атрибут | Тип | Описание |
|---|---|---|
| Url | string | URL ссылки. |
| Clicks | int | Количество кликов по ссылке. |
| UniqueClicks | int | Количество кликов по ссылке уникальными подписчиками. |
Примеры
Запрос:
GET https://api.esv2.com/v2/Api/LinkStatistics/764?apiKey=Ваш_API-ключ HTTP/1.1 Accept-Encoding: gzip,deflate User-Agent: Jakarta Commons-HttpClient/3.1 Host: api.esv2.com
Ответ:
HTTP/1.1 200 OK
Cache-Control: private
Content-Type: text/xml; charset=utf-8
Content-Encoding: gzip
Vary: Accept-Encoding
Server: Microsoft-IIS/7.5
Set-Cookie: ASP.NET_SessionId=znbbf255rwgtzketrup04q55; path=/; HttpOnly
X-AspNetMvc-Version: 1.0
X-AspNet-Version: 2.0.50727
X-Powered-By: ASP.NET
Date: Mon, 24 May 2010 13:05:25 GMT
Content-Length: 286
<ApiResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<Data>
<LinkStatistics>
<LinkStatistic>
<Url>http://www.msn.com</Url>
<Clicks>5</Clicks>
<UniqueClicks>1</UniqueClicks>
</LinkStatistic>
<LinkStatistic>
<Url>http://www.google.com</Url>
<Clicks>2</Clicks>
<UniqueClicks>1</UniqueClicks>
</LinkStatistic>
<LinkStatistic>
<Url>http://www.cnn.com</Url>
<Clicks>5</Clicks>
<UniqueClicks>1</UniqueClicks>
</LinkStatistic>
</LinkStatistics>
</Data>
</ApiResponse>