飞驼可视船期表 API

全球港到港船期查询 · 船舶航次挂靠港 · 多程中转 · 截关时间 — 一站式海运船期数据接口

飞驼可视船期表 API 整合全球主流船公司的班期数据，提供 港到港船期（直达+中转） 与 船舶船期（船名+航次） 两大核心查询能力。覆盖全球175个国家800个港口的直达船期、60个国家300个港口的中转船期，以及全球8000艘集装箱船的航次挂靠港数据（占全球集装箱船的95%），支持42家船公司查询，数据每天更新2次，是货代订舱、物流排程、供应链规划的核心数据基础设施。

📌 核心能力港到港直达+中转船期查询（最多8周/56天）；支持3程以上中转及每一程运输方式（大船/卡车/铁路/驳船/支线）；船舶历史航次挂靠港查询（近一年）；含截关/截单/截VGM等关键时间节点；共舱信息与标准化港口/码头数据。

800+

覆盖港口（直达）

42家

支持船公司

8000艘

集装箱船覆盖

2次/天

数据更新频率

应用场景与价值

船期表 API 为海运产业链各环节提供精准、全面的班期数据，帮助企业从“经验排舱”升级为“数据驱动订舱”。

核心应用场景

📦

货代订舱与报价

根据起运港/目的港快速筛选最优船期，对比船公司、航程、中转方案与截关时间，生成精准报价，提升订舱效率与客户响应速度。

🏭

制造业供应链排程

结合船期数据规划原材料采购与产成品出货节奏，精准匹配生产计划与海运班期，减少库存积压与断料风险。

🛒

跨境电商物流

为 FBA 头程、海外仓补货提供船期选型依据，结合截关时间倒推备货节奏，确保货物按时入仓，降低旺季断货风险。

🚢

船舶代理与港口运营

通过船舶航次挂靠港数据掌握船舶到港计划，优化泊位调度、引航安排与港口资源配置，提升港口运营效率。

📊

物流平台 SaaS 集成

将船期查询能力嵌入 TMS/FMS/CRM 系统，为客户提供一站式海运方案对比与在线订舱体验，增强平台粘性与转化率。

🔍

贸易合规与风控

通过船舶航次与挂靠港历史数据，核查货物实际运输路径，辅助贸易合规审查、制裁筛查与供应链风险评估。

产品价值

多船司统一查询： 一次接入即可查询42家船公司船期，无需逐一对接各船司官网或EDI，大幅降低集成与维护成本。
中转方案全覆盖： V2接口支持3程以上中转，返回每一程运输方式（大船/卡车/铁路/驳船/支线）及中转港ETA/ETD，满足复杂航线规划需求。
关键时间节点： 提供截关（cyCutoff）、截单（siCutoff）、截VGM（vgmCutoff）、截订舱（bookingCutoff）等时间，避免因错过截关导致甩柜。
标准化数据： 港口五字码、UNCODE、标准化码头名称、时区等字段统一规范，便于系统对接与数据比对。
共舱信息透明： 返回shareCabins共舱结果集，帮助用户识别同一舱位的多家船司，扩大可选船司范围。
船舶航次溯源： 支持查询近一年船舶历史航次挂靠港，为路径核查、运费核算、船舶调度提供历史依据。

业务覆盖范围

飞驼可视船期数据覆盖全球主要贸易航线与主流船公司，数据每天更新2次。

数据覆盖概览

港到港船期（直达+中转）

300港口

起运港支持全球60个国家最常用的300个港口的直达和中转船期服务

港到港船期（全球直达）

800港口

起运港支持全球175个国家的800个港口的直达船期服务

船舶船期

8000艘

全球8000艘集装箱船的船期服务，占全球集装箱船的95%

数据更新频率

指标	说明
更新频率	1天更新2次
查询范围	当前日期起最多8周（56天）
历史航次	船舶船期支持查询近1年历史航次

港到港船期支持船公司列表（42家）

英文简称	中文简称	SCAC	API传参	备注
ANL	澳航	ANNU	ANL
CMA	达飞	CMDU	CMA
CNC	正利	CNCL	CNC
COSCO	中远	COSU	COSCO
CUL	中联	CULU	CUL
DJS	东进	DJSL	DJS
DYS	东映	DYSL	DYS
EAS	达通	EASC	EAS
EMC	长荣	EGLV	EMC
ESL	阿联酋	EMIV	ESL
EUKOR	威客	EUKO	EUKOR	滚装船
FESCO	俄远东	FESO	FESCO
GOTO	共同海运	GOTO	GOTO
HAL	兴亚	HALC	HAL
HBS	汉堡南美	SUDU	MSK	已被MSK收购
HEDE	合德	HDUJ	HEDE
HMM	现代	HDMU	HMM
HPL	赫伯罗特	HLCU	HPL
IAL	运达	IALU	IAL
JINJIANG	锦江	JINX	JINJIANG
KKC	神原汽船	KMBU	KKC
KMTC	高丽	KMTC	KMTC
MATS	美森	MATS	MATS
MCC	MCC运输	MCPU	MSK	已被MSK收购
MSC	地中海	MEDU	MSC
MSK	马士基	MAEU	MSK
NSS	南星	NSSC	NSS
ONE	海洋网联	ONEY	ONE
OOCL	东方海外	OOLU	OOCL
PIL	太平	PABV	PIL
RCL	宏海	RCLC	RCL
SINO	中外运	SNTU	SINO
SINOKOR	长锦	SKMC	SINOKOR
SITC	海丰	SITC	SITC
SML	森罗商船	SMLM	SML
STX	世腾	POBU	STX
TSL	德翔	TSYN	TSL
TYS	太荣商船	TYSU	TYS
WHL	万海	WHLC	WHL
WWL	华伦威尔逊	WLWH	WWL	滚装船
YML	阳明	YMJA	YML
ZIM	以星	ZIMU	ZIM

⚠️ 注意部分船公司（如 HBS 汉堡南美、MCC运输）已被马士基（MSK）收购，调用时请使用 MSK 作为 API 传参。船舶船期接口的支持船公司列表与港到港船期略有差异，以接口返回为准。

港到港船期（直达+中转）

根据起运港、目的港和预计离港日期，查询当前日期起最多 8周（56天） 的船期数据，支持直达与中转方案筛选。

V2 接口升级相比V1接口，V2增加了：① 3程以上中转数据；② 每一程运输方式（大船/卡车/铁路/驳船/支线）；③ 中转港的ETA/ETD时间。

GET/vessel2/v2/schedule请求地址

请求参数

Header 参数

参数名	类型	必填	说明
Authorization	string	是	Bearer Token，格式：Authorization: Bearer ********************

Query 参数

参数名	类型	必填	说明	示例
polCode	string	是	起始港/地五字码，只支持大写	CNSHA
podCode	string	是	目的港/地五字码，只支持大写	USLGB
etd	string	是	预计离港日期，格式：yyyy-MM-dd	2025-07-20
eta	string	否	预计到港日期，与etd同时传入为组合查询；返回eta大于今天0点且小于传入eta的结果	2025-08-01
weeksOut	string	是	范围（周）：1=7天，2=14天，…，8=56天。对eta参数不生效	8
carriercd	string	否	船公司代码，只支持单个船司查询	OOCL
routeCode	string	否	头程航线代码	PCN3
isTransit	string	否	中转标识：直达0，中转1，不传返回全部	1
transitPortEn	string	否	第1次中转港口名	—
vessel	string	否	船名，支持大小写，针对返回数据的vessel字段查询	COSCO PRIDE
pageNum	string	否	第几页	1
pageSize	string	否	每页条数，最大1000，不传默认10条	1000

请求示例

cURL

curl --location 'http://openapi.freightower.com/vessel2/v2/schedule?polCode=CNSHA&podCode=USLGB&etd=2025-07-20&weeksOut=8&carriercd=OOCL&isTransit=1&pageNum=1&pageSize=1000' \
--header 'Authorization: Bearer <token>'

返回参数（核心字段）

参数名	类型	说明
statusCode	integer	状态码：20000有数据，20001无数据
content	array	船期数据列表
content 数组元素
carriercd / scac	string	船公司代码 / SCAC代码
routeCode / displayName	string	航线代码 / 标准航线代码
shareCabins	array	共舱结果集（含共舱船司、航线代码）
vessel / voyage	string	船名 / 航次
transportMode	string	运输方式：VESSEL大船、TRUCK卡车、RAIL铁路、FEEDER驳船、BARGE支线
imoNumber / mmsi / callSign	string	IMO号 / MMSI号 / 呼号
pol* / pod*	object	起运港/目的港信息（五字码、标准化名称、时区、国家、码头、UNCODE）
staticEtd / staticEta	string	计划离港/到港日期
etd / eta	string	预计离港/到港日期
totalDuration	integer	预计航程（天，eta与etd相减）
transitTime	integer	计划航程（天，staticEta与staticEtd相减）
isTransit	integer	中转1 / 直达0
transits	array	中转数据集合（中转港、运输方式、ETA/ETD、码头等）
cyCutoff	string	截关时间
siCutoff	string	截单时间
vgmCutoff	string	截VGM时间
bookingCutoff	string	截订舱时间
inlandCutoff	string	截港时间
updateTime	string	最后更新时间
total / pages	integer	总条数 / 总页数（分页）

返回示例（节选）

JSON · 200 成功

{
    "status": 200,
    "statusCode": 20000,
    "content": [
        {
            "scac": "COSU",
            "carriercd": "COSCO",
            "routeCode": "AWE2",
            "shareCabins": [
                { "scac": "CMDU", "carrier": "CMA", "routeCode": "MANB" },
                { "scac": "EGLV", "carrier": "EMC", "routeCode": "NUE2" },
                { "scac": "OOLU", "carrier": "OOCL", "routeCode": "ECX2" }
            ],
            "vessel": "COSCO PRIDE",
            "voyage": "087E",
            "transportMode": "VESSEL",
            "imoNumber": "9472153",
            "mmsi": "563286700",
            "polCode": "CNSHA",
            "polName": "SHANGHAI",
            "polTerminalCn": "洋一",
            "podCode": "USNYC",
            "podName": "NEW YORK,NY",
            "podTerminalCn": "MAHER",
            "staticEtd": "2026-03-19 04:30:00",
            "staticEta": "2026-04-16 08:00:00",
            "etd": "2026-03-20 04:30:00",
            "eta": "2026-04-19 08:00:00",
            "totalDuration": 30,
            "transitTime": 28,
            "isTransit": 1,
            "transits": [
                {
                    "portEn": "New York",
                    "portCode": "USNYC",
                    "transportMode": "TRUCK",
                    "eta": "2026-04-16 08:00:00",
                    "sort": 1
                }
            ],
            "cyCutoff": "2026-03-16 12:00:00",
            "updateTime": "2026-03-20 01:45:55"
        }
    ],
    "total": 19,
    "pages": 19
}

船舶船期（船名+航次）

根据船公司代码、船名和航次，查询该船舶近一年历史航次的 挂靠港及发生时间 ，包含完整的挂靠港序列、码头信息、运输事件等。

GET/vessel2/getVesselShipmentsHistory请求地址

请求参数

Header 参数

参数名	类型	必填	说明
Authorization	string	是	Bearer Token

Query 参数

参数名	类型	必填	说明	示例
carrierCode	string	是	船公司代码	ZIM
vesselName	string	否	船名	ZIM MOUNT ELBRUS
voyage	string	是	航次	8E

请求示例

cURL

curl --location --request GET 'http://openapi.freightower.com/vessel2/getVesselShipmentsHistory?carrierCode=ZIM&vesselName=ZIM%20MOUNT%20ELBRUS&voyage=8E' \
--header 'Authorization: Bearer <token>'

返回参数（核心字段）

参数名	类型	说明
statusCode	integer	状态码：20000有数据，20001无数据
data	array	返回数据列表
data 数组元素
service	object	船公司服务信息（carrierCode、serviceCode、serviceName、sharingServices共舱服务）
transports	array	挂靠港信息列表（按挂靠顺序排列）
transports 元素
location	object	港口信息（五字码、名称、英文名、时区、经纬度、挂靠序号locationSequence）
transportCategory	string	运输方式，如VESSEL
facilityName	string	码头/设施名称
facilityCategory	string	设施类别，如POTE（港口码头）
vessel	object	船舶信息（mmsi、vesselName）
voyage / voyageGroup	string	航次 / 航次组（如8E/8W_ZE6）
updateTime	string	数据更新时间
transportEvents 元素
eventClassifier	string	事件分类：EST预计 / ACT实际
transportEventCategory	string	事件类型：ARRI抵达 / DEPA离港
eventTime	string	事件发生时间
transportCall	object	对应的挂靠港详情（含港口、码头、船舶、航次）
total	integer	数据总条数

返回示例（节选）

JSON · 200 成功

{
    "statusCode": 20000,
    "message": "成功",
    "data": [
        {
            "service": {
                "carrierCode": "ZIM",
                "serviceCode": "ZCP",
                "serviceName": "ZCP",
                "sharingServices": [
                    { "carrierCode": "ZIM", "serviceCode": "ZCP" },
                    { "carrierCode": "MSC", "serviceCode": "AMBERJACK SERVICE" }
                ]
            },
            "transports": [
                {
                    "location": {
                        "locationCode": "CNYTN",
                        "locationName": "YANTIAN (GD)",
                        "portEn": "YANTIAN",
                        "portTimeZone": "8",
                        "lat": 22.585262,
                        "lon": 114.288850,
                        "locationSequence": 1
                    },
                    "transportCategory": "VESSEL",
                    "facilityName": "YANTIAN INTERNATIONAL CONTAINER TERMINAL",
                    "facilityCategory": "POTE",
                    "vessel": { "mmsi": 477941200, "vesselName": "ZIM Mount Elbrus" },
                    "voyage": "8E",
                    "voyageGroup": "8E/8W_ZE6"
                },
                {
                    "location": {
                        "locationCode": "KRPUS",
                        "locationName": "PUSAN",
                        "portEn": "BUSAN",
                        "portTimeZone": "9",
                        "lat": 35.112600,
                        "lon": 129.052383,
                        "locationSequence": 5
                    },
                    "facilityName": "BUSAN CONT TML (BCT)",
                    "voyage": "8E"
                },
                {
                    "location": {
                        "locationCode": "USSAV",
                        "locationName": "SAVANNAH (GA)",
                        "portTimeZone": "-4",
                        "lat": 32.083300,
                        "lon": -81.083300,
                        "locationSequence": 8
                    },
                    "facilityName": "GARDEN CITY TERMINAL",
                    "voyage": "8W"
                }
            ],
            "transportEvents": [
                {
                    "eventClassifier": "EST",
                    "transportEventCategory": "ARRI",
                    "eventTime": "2025-10-13 08:00:00",
                    "transportCall": {
                        "location": { "locationCode": "CNYTN", "locationName": "YANTIAN (GD)" },
                        "vessel": { "vesselName": "ZIM Mount Elbrus" },
                        "voyage": "8E"
                    }
                },
                {
                    "eventClassifier": "EST",
                    "transportEventCategory": "DEPA",
                    "eventTime": "2025-10-14 19:00:00"
                }
            ]
        }
    ],
    "total": 1
}

💡 提示 transports数组按 locationSequence 字段排序，可直接还原船舶完整挂靠港序列。航次组（voyageGroup）字段可关联去程与回程航次（如8E/8W），便于追踪船舶往返航线。

FAQ

常见问题

飞驼可视船期表API覆盖多少港口和船公司？

港到港直达船期覆盖全球175个国家800个港口，中转船期覆盖60个国家300个港口，支持42家船公司查询；船舶船期覆盖全球8000艘集装箱船，占全球集装箱船的95%。

船期数据的更新频率是多少？

船期数据每天更新2次，确保船期信息的时效性与准确性。建议在业务系统中设置合理的缓存策略，避免频繁调用。

港到港船期接口最多可查询未来多久的船期？

提供当前日期起最多8周（56天）的船期数据，通过weeksOut参数控制查询范围（1=7天，2=14天，…，8=56天）。

船舶船期接口可以查询历史航次吗？

可以，船舶船期接口（getVesselShipmentsHistory）支持查询近一年该船名历史航次的挂靠港及发生时间，包含挂靠港序列、码头、预计/实际抵达和离港时间。

如何区分直达和中转船期？

通过isTransit参数筛选：传入0返回直达船期，传入1返回中转船期，不传则返回全部。返回数据中isTransit字段标识该条船期是否为中转（1=中转，0=直达），中转数据包含transits集合。

V2接口相比V1有哪些升级？

V2接口增加了三项能力：① 支持3程以上中转数据查询；② 返回每一程的运输方式（VESSEL大船/TRUCK卡车/RAIL铁路/FEEDER驳船/BARGE支线）；③ 返回中转港的ETA/ETD时间，便于精确规划中转衔接。

被收购的船公司如何调用？

部分船公司已被马士基收购（如HBS汉堡南美、MCC运输），调用时请使用MSK作为carriercd参数。船舶船期接口中部分船司标注“业务层已覆盖”，同样使用母船司代码调用即可。

截关时间等关键节点有哪些？

港到港船期接口返回以下关键时间节点：截关（cyCutoff）、截单（siCutoff）、截VGM（vgmCutoff）、截订舱（bookingCutoff）、截港（inlandCutoff）、截海外舱单（manifestCutoff）、截放行条（cvCutoff），帮助用户合理安排出货节奏。