Документация для разработчика
Полная техническая документация с примерами запросов и ответов — на странице Документация API. Передайте ссылку вашему разработчику.
- Напишите вашему менеджеру или в клиентскую службу — мы включим доступ к API для вашего аккаунта
- Откройте Профиль → «API-доступ» (раздел появляется после включения)
- Нажмите «Создать токен»: укажите название (например «1С — основная база»), организацию, нужные доступы и срок действия
- Скопируйте токен и передайте его вашему разработчику
Токен показывается один раз
Сохраните токен сразу — повторно посмотреть его нельзя, только создать новый. Токен — это ключ к вашим ценам и заказам: не публикуйте его и не отправляйте в открытых чатах. Если токен мог утечь — отзовите его в том же разделе и создайте новый.
Проверка подключения
Первый запрос, который стоит сделать разработчику — проверка токена:
curl https://avstorg.ru/api/ext/v1/me \ -H "Authorization: Bearer ВАШ_ТОКЕН"
В ответе — название токена, его доступы и контекст: организация, тип цен, основной склад.
Доступы и роли
Токен получает только те доступы, которые вы отметили: каталог, чтение заказов, создание заказов. Если вы участник организации с ролью «Бухгалтер», доступ «Создание заказов» недоступен — это ограничение роли.
Срок действия и продление
Токен можно сделать бессрочным или задать срок действия при создании. Когда срок истекает, токен перестаёт работать (ошибка token_expired) — просто создайте новый в разделе «API-доступ» и замените его в вашей системе.
Безопасность токена
- Не публикуйте токен и не пересылайте его в открытых чатах и письмах
- Отдельный токен на каждую систему (1С, сайт, склад) — так проще отозвать один, не задев остальные
- Выдавайте только нужные доступы (например, без «Создание заказов», если он не нужен)
- Если токен мог утечь — сразу отзовите его и создайте новый