Основы работы с API
API Сам.Бизнес — универсальное решение для работы бизнеса с онлайн-платежами. API сервиса построено на REST-принципах, работает с реальными объектами и обладает предсказуемым поведением. С помощью нашего API вы можете отправлять запросы на выплаты, создавать реестры, добавлять самозанятых, выгружать отчеты и многое другое. API в качестве основного протокола использует HTTP, и подходит для разработки на любом языке программирования, который умеет работать с HTTP-библиотеками (cURL и другими).
API endpoint:
https://business.selfwork.ru/selfemployed/business/v1/
API поддерживает POST, PUT, GET-запросы. POST-запросы используют JSON-аргументы, GET-запросы работают со строками запросов. API всегда возвращает ответ в формате JSON, независимо от типа запроса.
Для использования API сервиса, администратору необходимо создать пользователя с соответствующими правами.
Пример запроса на проверку доступности API:
- cURL
- Javascript
curl --location --request GET 'https://business.selfwork.ru/selfemployed/business/v1/check' \
--header 'X-Login: example' \
--header 'X-Password: 591c0bcd4a41137fe9fce94dfba74e24'
var axios = require('axios');
var config = {
method: 'get',
url: 'https://business.selfwork.ru/selfemployed/business/v1/check',
headers: {
'X-Login': 'example',
'X-Password': '591c0bcd4a41137fe9fce94dfba74e24'
}
};
axios(config)
.then(function (response) {
console.log(JSON.stringify(response.data));
})
.catch(function (error) {
console.log(error);
});