Это старая версия документа!
Платформа CleverFormsTM предоставляет возможность внешним разработчикам программными средствами получать и записывать данные в CleverFormsTM. Одним из способов такого взаимодействия является использование CleverForms API.
CleverFormsTM API определяет набор функций, к которым разработчики могут совершать запросы и получать ответы. Взаимодействие происходит по протоколу HTTP. Преимуществом такого подхода является широкое распространение протокола HTTP, поэтому CleverFormsTM API можно использовать практически из любого языка программирования. CleverFormsTM API предназначено, в основном, для запросов с внешних серверов к серверам CleverFormsTM.
Все вызовы методов API — это GET или POST HTTP-запросы к URL <protocol>:<domain>/<appname>/handler/api. с некоторым набором параметров. Вы выбираете в документации нужный метод,
например, document.calculate, формируете запрос согласно документации метода, и осуществляете этот
запрос. В ответ на запрос вы получаете его результат, который также описан в документации каждой функции. Кодировка результата — UTF-8.
Например, на PHP для осуществления такого запроса можно использовать cURL, на Perl —
LWP::Simple, на Python — httplib, использовать cURL из командной строки и даже просто ваш браузер.
Данные запроса могут передаваться в виде query-строки (после знака ?) при использовании метода
GET, либо в теле POST-запроса. Помните, что все параметры должны быть закодированы с помощью URL
encoding.
На данный момент, API не делает различий между GET- и POST-запросами. Тем не менее, помните,
что существует ограничение на длину URL запроса — 2048 символов. Поэтому мы рекомендуем вам выполнять запросы на получение информации с помощью метода GET (они обычно легко умещаются в ограничение), а запросы на изменение данных — с помощью метода POST. Так вы не будете ограничены длиной запроса, кроме того, такое использование больше соответствует спецификации протокола HTTP.