Основы работы с 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

curl --location --request GET 'https://business.selfwork.ru/selfemployed/business/v1/check' \
--header 'X-Login: example' \
--header 'X-Password: 591c0bcd4a41137fe9fce94dfba74e24'

Javascript

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);
});