API: различия между версиями

Материал из WiKi - UserSide
Нет описания правки
Нет описания правки
Строка 8: Строка 8:


  Входящие параметры:
  Входящие параметры:
  api - ключ API ''(обязательно)''
  Обязательные:
kat - категория запроса
  api - ключ API
  subkat - подкатегория запроса ''(опционально)''
  kat - категория запроса
  sort_desc - обратная сортировка результата (1)
  Возможные:
   cp - кодировка (cp1251). По-умолчанию возвращается в кодировке utf8
   cp - кодировка ''(возможное значение: cp1251)''. По-умолчанию данные возвращаются в кодировке utf8.
   gz - возврат данных в сжатом формате (disable). По-умолчанию включено
   gz - возврат данных в сжатом формате ''(возможное значение: disable)''. По-умолчанию данные возвращаются в сжатом формате.
прочие параметры в завимости от категории:
  subkat - подкатегория запроса
  usercode - код абонента (tbl_base.CODE)
  sort_desc - обратная сортировка результата запроса ''(Возможное значение: 1)''
 
  Прочие параметры, в зависимости от категории. Например:
subkat - подкатегория запроса ''(опционально)''
  usercode - код абонента ''(tbl_base.CODE)''
 
  Пример запроса:
  Пример запроса:
  api.php?api=key&kat=abon&subkat=msg&usercode=1
  api.php?api=key&kat=abon&subkat=msg&usercode=1

Версия от 17:56, 27 марта 2015

Этот раздел описывает возможности использования встроенного API в САП "UserSide", что позволяет использовать встроенный функционал в собственных проектах.

API охватывает на данный момент не весь функционал и постепенно дорабатывается, так что данная страница будет иметь частые изменения и дополнения.

Принцип работы

За взаимодействие отвечает файл /api.php

Входящие параметры:
Обязательные:
 api - ключ API
 kat - категория запроса
Возможные:
 cp - кодировка (возможное значение: cp1251). По-умолчанию данные возвращаются в кодировке utf8.
 gz - возврат данных в сжатом формате (возможное значение: disable). По-умолчанию данные возвращаются в сжатом формате.
 subkat - подкатегория запроса
 sort_desc - обратная сортировка результата запроса (Возможное значение: 1)
 Прочие параметры, в зависимости от категории. Например:
  usercode - код абонента (tbl_base.CODE)

Пример запроса:
api.php?api=key&kat=abon&subkat=msg&usercode=1

Основная настройка

В основном файле конфигурации main/config/config.php добавьте (или настройте) переменную $zapikey, где укажите свой произвольный API-ключ.