Что это
Shippo API связывает магазин или внутреннее приложение с перевозчиками. По адресам, размерам и весу посылки можно получить варианты доставки, а затем отдельно купить этикетку выбранной услуги. Расчет и покупка - разные операции.
Shippo API не является языковой моделью. Для работы через AI-ассистента у Shippo есть отдельный MCP-сервер; обычную серверную интеграцию можно написать через REST. В любом варианте стоимость и маршрут нужно проверить до покупки.
Не считайте список перевозчиков обещанием доставки по любой стране. Сначала проверьте свое направление, условия аккаунта и доступность услуги. Для знакомства используйте test token и учебные данные.
Ключевые параметры
- Категория: Операционные задачи
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- Объект Shipment позволяет получить предложения подключенных перевозчиков.
- Расчет стоимости отделен от покупки этикетки через Transaction.
- Test mode позволяет отладить запросы без покупки рабочей доставки.
- Отслеживание и webhooks помогают обновлять статус в своем приложении.
Ограничения
- Маршруты и услуги зависят от перевозчиков и подключенного аккаунта.
- Тестовые цены могут отличаться от live; тестовая этикетка не годится для отправки.
- При покупке в live mode возникают реальные расходы.
- Ошибки адреса, единиц измерения и повторная покупка требуют защиты в вашей интеграции.
Как использовать
1. Подготовка. Создайте Shippo-аккаунт и в Developer keys получите test token с префиксом shippo_test_. Подготовьте учебный маршрут, поддерживаемый перевозчиком, и параметры коробки с явно указанными единицами веса и размеров.
2. Настройка. В серверном клиенте задайте Authorization: ShippoToken <TEST_TOKEN> и Content-Type: application/json. Возьмите пример Create shipment из официального руководства: address_from, address_to, parcels и async: false. Подставьте учебные данные, не используйте live token.
3. Первый результат. Выполните POST https://api.goshippo.com/shipments/. Из rates выведите provider, servicelevel.name, amount и currency. При пустом списке разберите messages, адреса и доступность перевозчика. Для этого результата не вызывайте /transactions/.
4. Проверка. Убедитесь, что ответ относится к тестовому режиму и нужному маршруту, а валюта и единицы корректны. Сравните варианты, не обещайте срок как гарантию. Перед live-покупкой отдельно подтвердите цену и услугу; при тайм-ауте сначала выясните результат операции, чтобы не купить этикетку дважды.
Примеры сценариев
- Показать оператору варианты доставки перед покупкой.
- Проверить расчет для двух размеров коробки.
- Обновить статус заказа после события отслеживания.
Доступ и оплата
- Модель оплаты: Оплата по использованию
- Пробный доступ: Да
- Работа в РФ: Нужно проверять
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
Тестовые вызовы и test labels предназначены для разработки без покупки рабочей доставки. Live-этикетки оплачиваются; API и веб-интерфейс могут иметь разные условия. Доступность нужного российского маршрута и оплаты необходимо проверить отдельно.
Когда не подходит
- Гарантировать обслуживание любого маршрута в России
- Считать тестовую цену окончательной рабочей ценой
- Покупать этикетку при неопределенном результате предыдущего запроса
Альтернативы
EasyPost также предоставляет интеграцию доставки. AfterShip Tracking ориентирован на отслеживание, не прямую замену покупки этикеток. Shopify Admin API работает с заказами магазина; доступ к перевозчикам для доставки нужно организовать отдельно.
