Maersk （獨立發行商）（預覽版）

馬士基航運資料的自訂連接器，包括位置、船舶、時間表和港口。這是公開參考資料。

此連接器適用於以下產品和區域：

服務	Class	Regions
副駕駛工作室	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
邏輯應用程式	標準	所有 Logic Apps 區域，但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部（DoD）
Power Apps	進階	除下列區域外的所有 Power Apps 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
Power Automate（自動化服務）	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）

連絡人
名稱	丹·羅馬諾
Email	dan.romano@swolcat.com

連接器中繼資料
Publisher	丹·羅馬諾
網站	https://developer.maersk.com/api-catalogue
隱私策略	https://terms.maersk.com/privacy
類別	資料

正在建立連線

連接器支援下列驗證類型：


預設值	建立連線的參數。	所有區域	不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱	類型	Description	為必填項目
API 金鑰	securestring	API 金鑰	對

節流限制

名稱	呼叫	續約期間
每個連線的 API 呼叫	100	60 秒

動作

取得位置清單	傳回馬士基支援的地點清單。
取得作用中連接埠	傳回 A.P. Moller-Maersk A/S 船隻呼叫的有效裝卸港清單
取得出貨截止日期	傳回給定船舶/航次/裝貨港的每個碼頭的裝運截止日期清單。
按港口獲取船期	傳回所提供過濾器的排程連接埠呼叫。
按船隻獲取船隻時刻表	傳回指定船舶和航程過濾器的船舶港口停靠時間表。
獲取船舶信息	傳回 A.P. Moller-Maersk A/S 營運的現役船隻清單
通過地理 ID 獲取運營商位置	依地理位置識別碼傳回位置清單

取得位置清單

作業識別碼：: GetLocations

傳回馬士基支援的地點清單。

傳回

response: array of Location

取得作用中連接埠

作業識別碼：: GetActivePorts

傳回 A.P. Moller-Maersk A/S 船隻呼叫的有效裝卸港清單

參數

名稱	機碼	必要	類型	Description
運營商代碼	carrierCodes	True	string	一或多個運營商代碼（例如 MAEU）。如果多重，則以逗號分隔。
國家代碼	countryCodes		string	可選的 ISO 3166-1 alpha-2 國家代碼（例如，美國、中國）

傳回

response: array of Port

取得出貨截止日期

作業識別碼：: GetDeadlines

傳回給定船舶/航次/裝貨港的每個碼頭的裝運截止日期清單。

參數

名稱	機碼	必要	類型	Description
ISO 國家代碼	ISOCountryCode	True	string	港口的 ISO 國家代碼（例如，美國）
裝貨港	portOfLoad	True	string	城市或港口名稱（例如休士頓）
船舶 IMO 編號	vesselIMONumber	True	string	船舶的 IMO 編號
航程	voyage	True	string	航程編號（例如，010E）

傳回

response: array of ShipmentDeadline

按港口獲取船期

作業識別碼：: GetSchedulesByPort

傳回所提供過濾器的排程連接埠呼叫。

參數

名稱	機碼	必要	類型	Description
聯合國地點代碼	UNLocationCode		string	港口的聯合國位置代碼（例如 USHOU）。如果未提供 cityName 和 carrierGeoID，則為必要項目。
城市名稱	cityName		string	港口城市的名稱。如果未提供 UNLocationCode 和 carrierGeoID，則為必要項目。
電信業者地理 ID	carrierGeoID		string	馬士基內部位置識別碼。如果未提供 UNLocationCode 和 cityName，則為必要。
開始日期	startDate		date	移轉排程的開始日期
日期範圍	dateRange		string	從開始日期開始的範圍
運營商代碼	carrierCodes	True	string	所需的運營商代碼

傳回

身體: PortSchedule

按船隻獲取船隻時刻表

作業識別碼：: GetSchedulesByVessel

傳回指定船舶和航程過濾器的船舶港口停靠時間表。

參數

名稱	機碼	必要	類型	Description
船舶 IMO 編號	vesselIMONumber		string	船舶的 7 位 IMO 編號
承運船代碼	carrierVesselCode		string	3 個字符的馬士基船舶代碼
開始日期	startDate		date	排程的開始日期
日期範圍	dateRange		string	從開始日期開始的範圍
運營商代碼	carrierCodes	True	string	馬士基要求的承運人代碼

傳回

身體: VesselSchedule

獲取船舶信息

作業識別碼：: GetVessels

傳回 A.P. Moller-Maersk A/S 營運的現役船隻清單

參數

名稱	機碼	必要	類型	Description
國際海事組織船舶編號	vesselIMONumbers		string	逗號分隔的 IMO 數字（例如，“9332999,9458030”）
承運船代碼	carrierVesselCodes		string	以逗號分隔的值清單（例如，「9332999,9458030」）

傳回

response: array of Vessel

通過地理 ID 獲取運營商位置

作業識別碼：: GetCarrierLocationByGeoID

依地理位置識別碼傳回位置清單

參數

名稱	機碼	必要	類型	Description
電信業者地理 ID	carrierGeoID	True	string	馬士基承運人 Geo ID

傳回

身體: CarrierLocation

定義

地點

名稱	路徑	類型
countryCode （國家代碼）	countryCode	string
國家名稱	countryName	string
城市名稱	cityName	string
locationType	locationType	string
locationName	locationName	string
carrierGeoID	carrierGeoID	string
UNRegion代碼	UNRegionCode	string
UNRegionName	UNRegionName	string

承運人位置

名稱	路徑	類型
countryCode （國家代碼）	countryCode	string
國家名稱	countryName	string
城市名稱	cityName	string
locationType	locationType	string
locationName	locationName	string
carrierGeoID	carrierGeoID	string
carrierRkst代碼	carrierRkstCode	string
carrierRkts代碼	carrierRktsCode	string
timeZoneID	timeZoneID	string
carrierCountryGeoID	carrierCountryGeoID	string
UNLocationCode	UNLocationCode	string
UNRegion代碼	UNRegionCode	string
UNRegionName	UNRegionName	string

船

名稱	路徑	類型
vesselIMONumber	vesselIMONumber	string
carrierVesselCode	carrierVesselCode	string
容器名稱	vesselName	string
船舶旗幟代碼	vesselFlagCode	string
容器呼叫符號	vesselCallSign	string

港口

名稱	路徑	類型
countryCode （國家代碼）	countryCode	string
國家名稱	countryName	string
UNLocationCode	UNLocationCode	string
城市名稱	cityName	string
端口名稱	portName	string
UNRegion代碼	UNRegionCode	string
carrierCityGeoID	carrierCityGeoID	string

設施

名稱	路徑	類型
locationType	locationType	string
locationName	locationName	string
carrierTerminalCode	carrierTerminalCode	string
carrierTerminalGeoID	carrierTerminalGeoID	string

服務

名稱	路徑	類型
承運人航程號碼	carrierVoyageNumber	string
carrierService代碼	carrierServiceCode	string
carrierServiceName	carrierServiceName	string

呼叫排程

名稱	路徑	類型
transportEventTypeCode	transportEventTypeCode	string
事件分類器代碼	eventClassifierCode	string
分類器日期時間	classifierDateTime	date-time

設施呼叫

名稱	路徑	類型
船	transport.vessel	Vessel
入站服務	transport.inboundService	Service
出站服務	transport.outboundService	Service
callSchedules	callSchedules	array of CallSchedule

港口呼叫

名稱	路徑	類型	Description
設備	facility	Facility
設施呼叫	facilityCalls	array of FacilityCall

貝塞爾呼叫

名稱	路徑	類型
設備	facility	Facility
入站服務	transport.inboundService	Service
出站服務	transport.outboundService	Service
callSchedules	callSchedules	array of CallSchedule

連接埠排程

名稱	路徑	類型	Description
傳輸埠	port	Port
連接埠呼叫	portCalls	array of PortCall

船期

名稱	路徑	類型	Description
船	vessel	Vessel
容器呼叫	vesselCalls	array of VesselCall

發貨截止日期

指定船舶/航程/港口組合的每個碼頭的截止日期清單。

名稱	路徑	類型	Description
終端名稱	shipmentDeadlines.terminalName	string	裝貨港碼頭的名稱
截止日期	shipmentDeadlines.deadlines	array of object
截止日期名稱	shipmentDeadlines.deadlines.deadlineName	string	截止日期的名稱
截止日期本地	shipmentDeadlines.deadlines.deadlineLocal	date-time	當地時間的截止日期時間戳記

共用方式為

Maersk （獨立發行商） （預覽版）