Для оптимізації логістичних процесів та точного планування ланцюжка постачання використовуються інструменти, що допомагають швидко отримувати дані про розклад перевезень. Ця інформація не є сталою, отже, необхідно знайти рішення для пошуку актуальних даних.
SeaRates Ship Schedules API надає можливість доповнити будь-яку з ваших ERP, TMS або CRM-систем якісними та актуальними даними про розклади для конкретних напрямків або суден. Ви можете ознайомитися з функціоналом в нашому гіді або у веб-версії на сайті SeaRates.com.
Команда SeaRates забезпечує швидку інтеграцію та прозору документацію з Ship Schedules API, з якою ви ознайомитесь в цій статті.
Гід з Ship Schedules API
Можливості та переваги
API Ship Schedules містить розширені дані з різних ресурсів. Для надання точних розкладів та маршрутних даних, інтеграція API базується на наступних принципах:
Ефективність: За допомогою нашого API ви розширюєте можливості вашої системи шляхом детального моніторингу щотижневих розкладів для обраних маршрутів та дедлайнів. Таким чином, ви отримуєте вичерпні та точні дані від судноплавних компаній по всьому світу.
Повнота обсягу даних: Охоплені всі основні світові напрямки, перевізники та порти.
Специфікація OpenAPI
Наша команда дотримується стандартів специфікації OpenAPI для інтеграції інструментів API. Завантажте специфікацію OpenAPI у форматі JSON з нашого Developer Portal. Таким чином, ви розширите можливості своїх сервісів за допомогою розширеного функціонала SeaRates у найпростіший спосіб.
Ship Schedules API: Загальна інформація
Ship Schedules API організовано на основі REST, що є найкращим вибором для безперебійної роботи вашої системи.
Наш API має передбачувані ресурсно-орієнтовані URL-адреси, приймає закодовані у формі тіла запитів, повертає відповіді у форматі JSON і використовує стандартні коди відповідей HTTP, аутентифікацію та дієслова.
Кінцеві точки
Усі кінцеві точки запиту API розкладів суден доступні за адресою sirius.searates.com та виключно за протоколом HTTPS.
Запити
Розклади by Points
Запит за посиланням 'GET': /schedule
Пошук розкладів by Points передбачає зазначення портів відправлення і прибуття, та подальшу фільтрацію отриманих результатів. Таким чином, користувачі отримують декілька розкладів для конкретного пункту призначення, використовуючи LOCODE для портів і SCAC для судноплавної лінії.
Ознайомтеся з примітками до параметрів для пунктів перевалки, судноплавних ліній і полів транспортування:
Параметри запиту
Ви повинні вказати наступні вхідні дані в параметрах запиту:
- Стандартний альфа-код перевізника (SCAC) судноплавної лінії
- LOCODE порту відправлення
- LOCODE порту прибуття
- "Почати з дати" - дата у форматі дд-мм-рррр або сьогодні
- "Тижні вперед" - тижні для відображення
- "Напрямок" для сортування за найранішим відправленням або найпізнішим прибуттям
Візуальні приклади параметрів ви знайдете на Developer Portal.
Ви також можете вибрати параметри режиму обслуговування "Пункт відправлення" та "Пункт призначення" відповідно до ваших потреб.
Відповідь
Для запиту by Points ви отримуєте інформацію про судно (назва, код), маршрут, пункти перевалки, UN/LOCODE порту та час транзиту.
Ознайомтеся зі Схемою відповіді (яка визначає всі можливі елементи відповіді) та Прикладом відповіді:
Розклади by Vessel
Запит за посиланням 'GET': /schedule/vessel
Використовуючи IMO судна, наш API дозволяє надавати розклади для конкретного судна протягом 3 місяців з дати запиту.
Параметри запиту
Детальна інформація про судно, перевізника та маршрут доступна лише після введення IMO, унікального ідентифікатора судна.
Ознайомтеся зі Схемою відповіді (яка визначає всі можливі елементи відповіді) та Прикладом відповіді:
Доступні перевізники
Запит за посиланням 'GET': /schedule/available-carriers
Третій запит, який надає наш API, - це інформація про доступних перевізників для розкладу. Перевізники можуть бути знайдені для розкладів by Points та by Vessel.
Параметри запиту
Вам необхідно зазначити фільтр за доступними перевізниками для пошуку розкладів by Points та by Vessel.
Відповідь
За допомогою API Ship Schedules ви зможете отримати список доступних перевізників для певних розкладів.
Ознайомтеся зі Схемою відповіді (яка визначає всі можливі елементи відповіді) і Прикладом відповіді:
У розділі Additional information ви знайдете список доступних перевізників, які підтримуються нашим API для пошуку розкладів за пунктами та суднами:
Висновок
Наша команда надає можливість інтегрувати API інноваційного інструменту для розширеного пошуку розкладу в будь-яку з ваших ERP, TMS або CRM систем для покращення ваших логістичних послуг. SeaRates реалізує ефективні рішення для спрощення операцій ланцюга постачання, допомагаючи логістичним провайдерам по всьому світу вирішувати повсякденні завдання.
Ознайомтеся з простою у використанні інтеграційною документацією на SeaRates Developer Portal та дізнайтеся в нашої служби підтримки про найкращі логістичні рішення.
Зв'яжіться з нами в будь-який час за адресою it.sales@searates.com для отримання допомоги в інтеграції послуг SeaRates у ваші бізнес-процеси.
