API цифровых товаров

API цифровых товаров позволяет программно управлять цифровым контентом, привязанным к товарам и заказам.

Данный инструмент разработки необходим для автоматизации выдачи, обновления и контроля доступа к цифровым товарам (например, программы, курсы, электронные книги) как при оформлении заказа, так и в рамках интеграций с внешними сервисами.

Получение состава заказа

Получение состава заказа позволяет узнать, какие лицензионные коды или цифровые товары были выданы покупателю.

1. Для получения заказа необходимы логин и пароль. Скопировать их можно в настройках расширения.

1.1 Перейдите в расширение "Цифровые товары":

1.2 Откройте вкладку "Настройки":

1.3 Внизу страницы будут доступны логин и пароль:

2. Для доступа к составу заказа, используя логин, пароль и id заказа, создайте запрос:

https://login:password@digital.insales.ru/api/orders/order_id.json

где login - логин, password - пароль, order_id - id заказа в inSales (отображается в адресной строчке в карточке заказа).

3. В полученном результате должен быть массив license_codes, в котором перечислены все отправленные клиенту коды.

Получение всех файлов товара

Получение всех файлов товара необходимо для загрузки списка цифровых активов товара, доступных для скачивания. 

# GET /api/products/:product_id/assets(.:format)

# GET /api/products/:product_id/variants/:variant_id/assets(.:format)

# GET /api/assets/:id(.:format)

Получение файла варианта

Получение всех файлов варианта товара необходимо для загрузки списка цифровых активов варианта товара, доступных для скачивания. 

# GET /api/products/:product_id/variants/:variant_id/assets(.:format)

Получение конкретного файла

Получение конкретного файла позволяет обратиться к отдельному цифровому активу по его ID

# GET /api/assets/:id(.:format)

Удаление

Удаление файла нужен для того, чтобы убрать ненужный или устаревший цифровой контент товара.

# DELETE /api/products/:product_id/variants/:variant_id/assets(.:format) api/assets#destroy

# DELETE /api/assets/:id(.:format)

Создание

Создание файла позволяет загрузить новый контент товара.

 # POST /api/products/:product_id/variants/:variant_id/assets(.:format)

Ожидается params.require(:asset).permit(:src, :filename, :attachment)