Разработка классического RESTful API
Стандартный REST API, который подключит любая система — 1С, CRM, маркетплейс или партнёр — без нестандартных протоколов и «костылей».
- Стандарт де-факто
REST понимают 1С, CRM, маркетплейсы и любые партнёры.
- Предсказуемость
Ресурсы, HTTP-методы и коды ответа по единым правилам.
- Идемпотентность
Повтор запроса после сбоя не создаёт дублей.
- Кэширование
GET-запросы кэшируются на уровне HTTP.
Сколько стоит
Этапы работы
- 01Аудит
Изучаем текущую инфраструктуру и код, находим риски и узкие места. Бесплатно.
- 02Проектирование
Предлагаем архитектуру, фиксируем сроки, бюджет и критерии готовности.
- 03Внедрение
Разрабатываем и настраиваем, покрываем тестами, передаём документацию.
- 04Поддержка
Мониторинг, реакция на инциденты по SLA и развитие системы.
Принципы хорошего REST API
REST — это договорённость: каждый объект (заказ, товар, клиент) — ресурс со своим адресом, а действие задаётся HTTP-методом. Такой API читается без документации и подключается к 1С и CRM стандартными средствами.
| Метод | Что делает | Идемпотентен |
|---|---|---|
| GET /orders | Получить список | Да |
| POST /orders | Создать заказ | Нет (ключ идемпотентности) |
| PUT /orders/{id} | Заменить заказ | Да |
| DELETE /orders/{id} | Удалить заказ | Да |
Что закладываем в API
JSON и коды состояния HTTP
Единый формат ответов и ошибок: 2xx — успех, 4xx — ошибка клиента с понятным описанием, 5xx — сбой на нашей стороне с записью в журнал.
Идемпотентность
PUT и DELETE идемпотентны по определению, для POST используем ключ идемпотентности — повтор при обрыве связи не создаёт дубль заказа.
HATEOAS и навигация
Где это полезно, ответ содержит ссылки на связанные ресурсы — клиент переходит от заказа к клиенту и счёту, не собирая адреса вручную.
Смотрите также: проектирование в Swagger, безопасность JWT, GraphQL. Весь кластер — REST API и интеграции.
Частые вопросы
Почему REST, а не свой формат обмена?
REST — стандарт: его поддерживают 1С, Битрикс24, amoCRM, маркетплейсы и любые языки. Партнёру не нужно изучать ваш собственный протокол.
Что такое идемпотентность и зачем она нужна?
Повторный одинаковый запрос даёт тот же результат. Если связь оборвалась и 1С отправила заказ ещё раз, дубль не появится.
Как API сообщает об ошибках?
Кодами состояния HTTP (400, 401, 404, 409, 500) и понятным телом ответа в JSON — интегратор сразу видит, что пошло не так.
Как менять API, не ломая старые интеграции?
Версионированием: новая версия живёт по своему адресу, старая работает, пока клиенты не перейдут.
Можно ли подключить к REST API 1С без доработки?
Обычно нужна небольшая настройка HTTP-сервиса или обработки в 1С — это входит в работу.
Расскажите, что нужно сделать
Оставьте контакты или напишите в мессенджер: разберём задачу и предложим решение.
Телефон для связи8 (967) 858-85-55