# Rent in Hand API

> REST API системы учёта проката Rent in Hand: клиенты, аренды, инвентарь, комплекты, магазин и склад, ремонт, доставка. Все методы — под адресом https://api.rentinhand.ru/v2/… и требуют авторизации.

Ключевые факты для интеграции: хост только `api.rentinhand.ru` (без префикса `/api/`). Авторизация — API-токен: войти `POST /v2/login` логином и паролем пользователя кабинета, затем `POST /v2/api-token` с заголовком `Authorization: Bearer <токен доступа>` — в ответе `data.token`; его передавать в заголовке `Authorization: Bearer <API-токен>` (для совместимости принимается и параметр `?get_token=`). Токен действует весь оплаченный период тарифа (на тестовом периоде — до конца тестового) и продлевается вместе с тарифом: перевыпускать его после оплаты не нужно; пока следующий период не оплачен, запросы получают 401 с кодом TOKEN_EXPIRED, после продления тот же токен снова работает. Действует только последний выпущенный; без действующего тарифа `POST /v2/api-token` отвечает 422 с кодом API_TOKEN_NO_TARIFF или 403 с кодом TARIFF_EXPIRED. Занятая позиция при сохранении аренды — 409 с кодом INVENTORY_BUSY. Списки постраничные: `per_page` — от 1 до 5000, вне границ — 422. У картинок рядом с `full_src` и `avatar` приходят `sizes` и `avatar_sizes` — готовые ссылки на уменьшенные копии (xs, sm, md, xl, xxl) и оригинал (orig). Токен виджета из кабинета (32 символа, Профиль → Токен виджета) — не ключ API: он принимается только в `?get_token=` и только на маршрутах виджета бронирования; вне их API отвечает 403 с кодом WIDGET_TOKEN_SCOPE и ссылкой на страницу про API-токен. Ответы — JSON, даты — ISO 8601 в часовом поясе организации.

## Документация

- [Начало работы](https://api.rentinhand.ru/docs/getting-started.md): хост, авторизация, ошибки, пагинация, даты, медиа, ограничения — в markdown
- [API-токен](https://api.rentinhand.ru/docs/api-token.html): как выпустить API-токен и что делать при ошибке WIDGET_TOKEN_SCOPE
- [Справочник методов](https://api.rentinhand.ru/docs/): все методы с параметрами и примерами ответов
- [OpenAPI 3](https://api.rentinhand.ru/docs/openapi.yaml): машинно-читаемая спецификация
- [Коллекция Postman](https://api.rentinhand.ru/docs/collection.json): готовые запросы с переменной baseUrl и авторизацией

## Optional

- [Личный кабинет](https://lk.rentinhand.ru): токен виджета (Профиль → Токен виджета)
- [Сайт Rent in Hand](https://rentinhand.ru)