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

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


Переадресация на карточку объекта по какому-то признаку
Переадресация на карточку объекта по какому-то признаку
Дополнительные параметры:
subkat - тип объекта ''(возможное значение: abon)''
typer - тип анализируемых данных ''(возможное значение: tel)''
value - данные ''(текстовое значение)''
Пример запроса:
api.php?api=key&kat=redirect&subkat=abon&typer=tel&value=380971234567
=== newin ===
Форма заявки на подключение
Пример реализации: http://userside.ua/userside/script/newin/sample.php


  Дополнительные параметры:
  Дополнительные параметры:

Версия от 18:05, 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-ключ.

Категории

redirect

Переадресация на карточку объекта по какому-то признаку

Дополнительные параметры:
subkat - тип объекта (возможное значение: abon)
typer - тип анализируемых данных (возможное значение: tel)
value - данные (текстовое значение)

Пример запроса:
api.php?api=key&kat=redirect&subkat=abon&typer=tel&value=380971234567

newin

Форма заявки на подключение Пример реализации: http://userside.ua/userside/script/newin/sample.php

Дополнительные параметры:
subkat - тип объекта (возможное значение: abon)
typer - тип анализируемых данных (возможное значение: tel)
value - данные (текстовое значение)

Пример запроса:
api.php?api=key&kat=redirect&subkat=abon&typer=tel&value=380971234567