|
|
| (не показаны 54 промежуточные версии 7 участников) |
| Строка 1: |
Строка 1: |
| − | == Введение == | + | {{#seo: |
| − | ПланФикс API реализовываем ввиде чистого XML поверх HTTP.
| + | |title=Разработчикам: API |
| − | Все API выполняются через POST запросы.
| + | |titlemode=append |
| − | Доступ к интерфейсу осуществляется по адресу '''https://api.planfix.ru/xml/'''.
| + | |keywords=планфикс, апи, api |
| | + | |description=Разработчикам: API |
| | + | }} |
| | | | |
| | + | *[[XML API v1]] |
| | + | *[[REST API]] |
| | + | *[[Отправка Post-запросов при помощи автоматических сценариев |Получение информации об изменениях в реальном времени]] |
| | + | *[[API для телефонии]] |
| | + | *[[API для чатов]] |
| | + | *[[API для отправки sms]] |
| | | | |
| − | == Регистрация приложения ==
| |
| − | Для того чтоб приложение могло начать работу, необходимо его зарегистировать на странице [https://dev.planfix.ru https://dev.planfix.ru]. В результате регистрации будет получены два ключа: аутентификационный ключ и ключ подписи.
| |
| | | | |
| − | | + | == Перейти == |
| − | == Пакеты запросов/ответов ==
| + | *[[ПланФикс]] |
| − | Пакет запроса имеет следующую структуру
| |
| − | <source lang="xml">
| |
| − | <request method="{Имя_вызываемой функции}">
| |
| − | <account></account> <!-- обязательное поле и присутствует во всех запросах -->
| |
| − | <sid></sid> <!-- ключ сессии полученный в результате выполнения функции auth -->
| |
| − | <!-- ... -->
| |
| − | </request>
| |
| − | </source>
| |
| − | Пакет ответа имеет следующую струтуру
| |
| − | <source lang="xml">
| |
| − | <respose status="{ok|error}">
| |
| − | <code>xxxx</code> <!-- присутствует если статус ошибки error -->
| |
| − | <!-- тело ответа -->
| |
| − | </response>
| |
| − | </source>
| |
| − | Все ответы на запросы списков содержат в корневом элементе два атрибута. '''totalCount''' - количество всех элементов удовлетворяющих условию, '''count''' - количество возвращенных элементов в результате. Например:
| |
| − | <source lang="xml">
| |
| − | <respose status="ok">
| |
| − | <actions count="5" totalCount="23">
| |
| − | </actions>
| |
| − | </response>
| |
| − | </source>
| |
| − | Расшифровки кодов ошибки можно посмотреть на странице [https://api.planfix.ru/error.xml https://api.planfix.ru/error.xml]. Структура файла:
| |
| − | <source lang="xml">
| |
| − | <errors>
| |
| − | <code id="хххх">описание ошибки</code>
| |
| − | <!-- ... -->
| |
| − | </errors>
| |
| − | </source>
| |
| − | | |
| − | | |
| − | == Список функций ==
| |
| − | *[[ПланФикс API:Аутентификация|Аутентификация]]
| |
| − | *[[ПланФикс API:Проекты|Проекты]]
| |
| − | *[[ПланФикс API:Задачи|Задачи]]
| |
| − | *[[ПланФикс API:Действия|Действия]]
| |
| − | *[[ПланФикс API:Управление группами пользователей|Управление группами пользователей]]
| |
| − | *[[ПланФикс API:Сотрудники|Сотрудники]]
| |
| − | *[[ПланФикс API:Клиенты|Клиенты]]
| |
| − | *[[ПланФикс API:Контакты|Контакты]]
| |
| − | *[[ПланФикс API:Работа с файлами|Работа с файлами]]
| |
| − | *[[ПланФикс API:Лог|Лог]]
| |
| − | | |
| − | == Смотри также == | |
| − | *[[ПланФикс API:Коды ошибок|Коды ошибок]] | |
