Подключение к API ShipStation

ShipStation — удобный сервис для формирования отправлений. Вы можете передавать параметры посылки в API и получать стоимость доставки для FedEx, USPS, DHL, APC или других служб. Если вас устраивает стоимость одной из них, вы можете сделать запрос на создание лейбы и получить трек-номер. Используя такой подход, есть возможность обработать десятки или сотни посылок и сразу передать их перевозчику. Если вы хотите, чтобы все службы были собраны в одном месте, то ShipStation — это то, что вам нужно.

Подключение к API ShipStation

Для начала подключения API ShipStation, следует выполнить следующие шаги:

• Прежде чем начать работу с API, вам необходимо создать учетную запись;
• В личном кабинете добавьте службы доставки, с которыми планируете работать;
• Для доступа к API необходимы API ключи, которые предоставляются со стороны сервиса;
• Ознакомьтесь с документацией API ShipStation, где вы найдете полную информацию о доступных эндпоинтах, параметрах запросов и форматах ответов;
• Определите, какие эндпоинты (API endpoints) вам нужны для вашей бизнес-логики, например, создание заказов, отслеживание отправлений и т. д.;
• Используйте ваши API ключи для подключения к API ShipStation с помощью HTTP-запросов (например, GET, POST, PUT) к соответствующим эндпоинтам;
• Проверьте, корректно ли работает подключение к API, отправляя тестовые запросы и проверяя полученные ответы;
• Обрабатывайте полученные данные, которые возвращаются от API, для выполнения необходимых действий в вашей системе.

Обзор основных функций и возможностей

ShipStation, как и Payoneer, использует JSON API с популярным методом подписи запросов с помощью заголовка "Authorization" со значением 'Basic'. При этом идентификатор ($id) и ключ ($key) предоставляются разработчику со стороны ShipStation.

Сервис работает с двумя измерениями размера — сантиметры и дюймы, а также с тремя измерениями веса — граммы, унции и фунты. Вы можете передавать параметры посылок и получать стоимости пересылки для различных методов доставки от всех доступных служб, и выбирать наиболее подходящий. Кроме того, учитываются различные методы упаковки, что делает выбор службы и метода доставки более гибким. 

Все API-сущности, такие, как пользователи, заказы и посылки, разделены, что позволяет составлять запросы удобным способом, чем не могут похвалиться все API. Каждая из служб доставки имеет свои особенности, которые, в некотором смысле, отражаются и на API ShipStation. Это можно увидеть, например, в работе с видами упаковок при выборе FedEx, но такие особенности открываются лишь на этапе подключения самого API. Поэтому для обработки данных некоторых служб доставки может понадобиться дополнительная настройка. Однако с другой стороны, ShipStation является качественным универсальным сервисом, подключение которого часто освобождает вас от необходимости подключать и интегрировать API разных служб, что позволяет сэкономить время на разработке.

Удобная система возврата ошибок, которая учитывает состояние HTTP-кодов, помогает разработчикам правильно обрабатывать непредвиденные ошибки. API ShipStation имеет ограничение в 40 запросов в минуту для одного API-аккаунта. Более частое использование требует индивидуальной договоренности с ShipStation, и именно этот момент может быть препятствием для вашего будущего высоконагруженного проекта, использующего данный сервис.

Параметры запроса на создание лейбы

Важным преимуществом является возможность получать онлайн PDF-лейбы для печати и наклеивания на почтовые отправления. Это позволяет избавить вас от лишнего ожидания в пунктах отправки и существенно экономит время. На лейбу, которая создается через API ShipStation, можно передать разнообразные данные, необходимые для обработки заказа. Вот некоторые из них:

• Имя и адрес отправителя и получателя;
• Дата отправления;
• Вес и размеры посылки;
• Название, количество и стоимость товара в посылке;
• Информация о страховке;
• Особые указания по обработке или доставке посылки (например, субботняя доставка, наличие алкоголя или другое).

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

Заключение

В целом, ShipStation — удобный инструмент для удаленного создания отправок и других функций. Важно убедиться, будет ли для вас удобно работать с допустимым лимитом запросов и устроит ли вас скорость генерации лейб.

В статье наши специалисты объясняют, как подключить API Easypost, конкурента ShipStation. У нас есть опыт подключения обоих агрегаторов, поэтому мы можем предоставить консультации и помощь в подключении любого из них. Будем рады сотрудничеству.