REST JSON API · версия 1

Оформляйте посылки прямо из своей системы

Магазин, склад, CRM или ИИ-агент могут сами посчитать цену, оформить отправление и получить этикетку. API бесплатный, ключ создаётся в кабинете за пару минут.

API бесплатный: платите только за доставку по своим тарифам
Подключение за пару минут: ключ выдаётся сразу
Обычный HTTP и JSON: подойдёт любой язык и любая платформа

Начать бесплатно Документация для разработчика

Для программистов и ИИ-агентов

Четыре шага от нуля до первой посылки

Ниже — весь путь целиком. Если подключение делает ИИ-агент, ему хватит этой страницы и ссылок на документацию в конце.

Зарегистрируйтесь

Аккаунт создаётся по ссылке из письма: пароль не нужен. Тарифы у API те же, что в кабинете.

Создайте ключ

Раздел «API» в шапке кабинета. Ключ показывается один раз, отзывается в один клик, живёт в заголовке Authorization: Bearer.

Проверьте два вызова

Расчёт цены работает без ключа — им удобно убедиться, что запрос собран верно. Оформление уже требует ключ.

Загляните в документацию

Полный список полей, коды ошибок и примеры ответов — в техдокументации и в машиночитаемой OpenAPI-спеке.

Расчёт цены по всем службам

curl -G https://yousend.lv/api/production/v1/services/calculate \
  -d country_code=de \
  -d zip_code=10115 \
  -d package_type=1 \
  -d send_adr=0 \
  -d weight[]=2 \
  -d length[]=30 -d width[]=20 -d height[]=10

Оформление посылки

curl -X POST https://yousend.lv/api/production/v1/services/order-store \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: shop-order-1042' \
  -d '{"service_code":"dpd_classic","package_type":"1",
       "send_adr":"0","reason_for_export":"sold",
       "country_code":"de","zip_code":"10115",
       "recipient_name":"Anna Berg","recipient_city":"Berlin",
       "recipient_address_1":"Torstrasse 1",
       "recipient_phone":"4915112345678",
       "recipient_email":"anna@example.com",
       "parcel_description":"Books",
       "parcel_price":"25.00","parcel_currency":"0",
       "parcel_pickup_date":"2026-08-03 12:00:00",
       "parcel_pickup_address":"Lacplesa iela 87, Riga",
       "weight":["2"],"length":["30"],
       "width":["20"],"height":["10"]}'

OpenAPI-спека в JSON

Возможности

Что уже умеет API

Список честный: здесь только то, что работает сегодня.

Расчёт цены по всем службам

Один запрос — цены и сроки всех доступных курьерских служб на этот адрес и габариты. Ключ для расчёта не нужен.

Оформление посылки

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

Подтверждение отправления

Отдельный вызов передаёт посылку перевозчику и запускает забор. Раньше эта кнопка была только в кабинете.

PDF-этикетка по ссылке

После подтверждения в ответе приходит ссылка на этикетку: печатайте её из своей системы, заходить в кабинет не нужно.

Защита от двойных посылок

Заголовок Idempotency-Key: если ответ потерялся и запрос ушёл повторно, вернётся прежняя посылка, а не вторая.

Список и детали своих посылок

Статусы, трек-номера и суммы по вашим отправлениям. Ключ видит только ваши посылки, чужие недоступны.

Вебхук с трек-номером

Как только перевозчик выдал номер, мы сами постучимся на ваш адрес — опрашивать нас в цикле не нужно.

Платформы

Готовые интеграции

Для WooCommerce есть готовый плагин — скачайте и поставьте сами. По остальным площадкам напишите нам в WhatsApp: подключение обсуждаем сразу с живым человеком.

WooCommerce Готово

Бесплатный плагин для магазинов на WordPress: покупатель видит цену курьера в корзине, а вы оформляете посылку и печатаете этикетку прямо из карточки заказа. Программист не нужен — установка занимает пару минут.

Как установить Скачать плагин

Shopify Готово

Пять минут в своей же админке — и заказы Shopify оформляются в два клика: адрес, телефон и состав подставляются сами, а трек-номер возвращается в магазин автоматически. Ни разработчика, ни App Store, ни абонплаты.

Создайте приложение в своей админке Shopify
Вставьте токен на странице Shopify кабинета
Заказы появятся сами, трек уйдёт обратно автоматически

Подключить за 5 минут Подключить в кабинете

Mozello Скоро

Интеграция для магазинов на Mozello уже написана и ждёт одобрения самой платформы. Напишите нам — подключим вас первыми, как только её опубликуют.

Хочу подключить Mozello

Etsy

Отправляете заказы с Etsy? Обсудим, как связать магазин с YouSend, и подберём решение под ваш поток.

Запросить подключение

eBay

Продаёте на eBay? Расскажите про объём и площадку — предложим схему подключения.

Запросить подключение

Готовы автоматизировать отправку?

Создайте ключ и попробуйте первый запрос. Если что-то не сходится — напишите, поможем разобраться.

Начать бесплатно Спросить в WhatsApp