getCatalogsList¶
Описание метода¶
Метод возвращает список всех подключенных каталогов. Возвращаемые данные могут быть как в формате json, так и оформленны в теги html.
Параметры вызова¶
| параметр | обязательный | описание | возможные значения | значение по умолчанию |
| clientId | - | ID клиента | Если параметр clientId не задан, то метод вернет все возможные каталоги | |
| format | - | формат возвращаемых данных | html или json | html |
| language | - | Язык | ru или en | ru |
| domainName | - | Домен каталогов (см. Использование собственного домена) | ||
| buttonType | - | Тип кнопки | defaultWithShadow или defaultWithoutShadow | defaultWithoutShadow |
| splitByRegion | - | Разделять ли данные по регионам | on или off | on |
| isNeedLocaleName | - | Нужно ли отображать локализованное название бренда | on или off | off |
| isNeedLocaleNameWrap | - | Нужно ли <BR> перед локализованным названием бренда | on или off | off |
| isNeedOwnClasses | - | Нужно ли задавать отдельные классы для html-тегов | on или off | off |
Последние 4 параметра (splitByRegion, isNeedLocaleName, isNeedLocaleNameWrap, isNeedOwnClasses); действуют только тогда, когда запрашиваются данные в формате html
Возвращаемые данные¶
Возвращает список ссылок на каталоги.
Получение данных в виде html:¶
Пример php-кода страницы, запрашивающей данные в формате html:
<?
header("Content-type: text/html; charset=utf-8");
?>
<html>
<head>
<link rel="stylesheet" href="ilcats.css">
</head>
<body>
<span class='ilcatsCss'>
<?php
$st = file_get_contents("http://commonapi.ilcats.ru/getCatalogsList/?splitByRegion=on&format=html&language=ru&isNeedLocaleName=on&isNeedLocaleNameWrap=on&buttonType=defaultWithShadow&clientId=");
echo $st;
?>
</span>
</body>
</html>
Соответствующий файл таблицы каскадных стилей:
.divButtonIlcatsCatalog {
text-align: center;
float: left;
font-size: 12px;
text-decorations: none;
width: 130px;
}
.divButtonIlcatsCatalog a:link, a:visited {
text-align: center;
float: left;
font-size: 12px;
text-decoration: none;
color: green;
font-weight: bold;
}
.divRegionIlcatsCatalog {
float: left;
width: 100%;
margin: 0px 0px 50px 0px;
}
.divRegionIlcatsCatalog H2 {
color: #585f69;
margin-top: 5px;
text-shadow: none;
font-weight: normal;
font-family: 'Open Sans', sans-serif;
font-size: 24px;
line-height: 33px;
}
Получение данных в формате json¶
Пример запроса: http://commonapi.ilcats.ru/getCatalogsList/?splitByRegion=on&format=json&language=ru
Возвращаемые данные¶
Метод возвращает объект/массив data, содержимое которого зависит от параметра splitByRegion
1. Если параметр splitByRegion отличается от on или не задан, то массив data состоит из массива catalogs, каждый элемент которого содержит поля:
| id | ID каталога в нашей системе |
| url | Ссылка на каталог |
| imageUrl | Ссылка на логотип каталога |
| nameEng | Название каталога на английском языке |
| nameLoc | Название каталога в запрашиваемой локали |
| regionNameEn | Название региона(или типа для мото/квадро и т.п.) каталога на английском языке |
| regionNameLoc | Название региона(или типа для мото/квадро и т.п.) каталога в запрашиваемой локали |
2. Если параметр splitByRegion равен on, то массив data состоит из массива regions, каждый элемент которого содержит поля:
| regionNameEn | Название региона(или типа для мото/квадро и т.п.) каталога на английском языке |
| regionNameLoc | Название региона(или типа для мото/квадро и т.п.) каталога в запрашиваемой локали |
| catalogs | Массив, содержащий объекты, аналогичные п.1, но без regionNameEn и regionNameLoc |
Обновлено Артем больше 6 лет назад · 14 изменени(я, ий)