关于eDIS Public API中HTTP code及HTTP message更新的通知
发布时间:2025-09-25
一直以来，eBay致力于为卖家提供稳定高效的平台化运营服务。为了提升服务质量， SpeedPAK物流服务的下单平台eDIS已更新其Public API中的HTTP code及HTTP message以及相关Error code list，请各位将系统报文逻辑及时更新：
（1） HTTP code更新对比：
原来：
eDIS Public API版本各接口HTTP code统一响应为：200 /401 /500；
现在：
HTTP Code及HTTP Message将细化更新如附表2，如HTTP Code响应200/201/204则为成功，您可直接参考，无需查看后续消息集：若响应其他HTTP Code，如400/401/500才需要查看消息集，具体参考附表3 Error code list。
因此，请各位开发者确认各自系统正确的返回报文json格式，并及时按照以下更新调整报文逻辑。以重复创建bundle接口报错为例：
原来：
返回的报文是：
http code：200
{
"errors": [
{
"message":
"The status of packages must be TO_BE_SHIPPED.",
"errorId":
355803
}
]
}
现在：
返回的报文是：
http code：400
{
"errors": [
{
"message":
"The status of packages must be TO_BE_SHIPPED.",
"errorId":
355803
}
]
}
具体详细介绍请参考API文档（英文版）：https://developer.ebay.com/api-docs/sell/edelivery_international_shipping/overview.html
（2）HTTP code及HTTP message更新总览：
|
API |
url |
method |
http code |
http message |
|
createAddressPreference |
address_preference |
POST |
201 |
Created |
|
400 |
Bad Request |
|||
|
401 |
Unauthorized |
|||
|
404 |
Not found |
|||
|
500 |
Internal Server Error |
|||
|
createComplaint |
complaint |
POST |
201 |
Created |
|
400 |
Bad Request |
|||
|
401 |
Unauthorized |
|||
|
500 |
Internal Server Error |
|||
|
createConsignPreference |
consign_preference |
POST |
201 |
Created |
|
400 |
Bad Request |
|||
|
401 |
Unauthorized |
|||
|
500 |
Internal Server Error |
|||
|
createPackage |
package |
POST |
201 |
Created |
|
400 |
Bad Request |
|||
|
401 |
Unauthorized |
|||
|
500 |
Internal Server Error |
|||
|
bulkCancelPackages |
package/bulk_cancel_packages |
POST |
200 |
OK |
|
401 |
Unauthorized |
|||
|
404 |
Not found |
|||
|
500 |
Internal Server Error |
|||
|
cancelPackage |
package/{package_id}/cancel |
POST |
204 |
No Content |
|
400 |
Bad Request |
|||
|
401 |
Unauthorized |
|||
|
404 |
Not found |
|||
|
500 |
Internal Server Error |
|||
|
bulkConfirmPackages |
package/bulk_confirm_packages |
POST |
200 |
OK |
|
401 |
Unauthorized |
|||
|
404 |
Not found |
|||
|
500 |
Internal Server Error |
|||
|
confirmPackage |
package/{package_id}/confirm |
POST |
204 |
No Content |
|
400 |
Bad Request |
|||
|
401 |
Unauthorized |
|||
|
404 |
Not found |
|||
|
500 |
Internal Server Error |
|||
|
bulkDeletePackages |
package/bulk_delete_packages |
POST |
200 |
OK |
|
401 |
Unauthorized |
|||
|
404 |
Not found |
|||
|
500 |
Internal Server Error |
|||
|
deletePackage |
package/{package_id} |
DELETE |
204 |
No Content |
|
400 |
Bad Request |
|||
|
401 |
Unauthorized |
|||
|
404 |
Not found |
|||
|
500 |
Internal Server Error |
|||
|
getActualCosts |
actual_costs |
GET |
200 |
OK |
|
400 |
Bad Request |
|||
|
401 |
Unauthorized |
|||
|
404 |
Not found |
|||
|
500 |
Internal Server Error |
|||
|
getAddressPreferences |
address_preference |
GET |
200 |
OK |
|
401 |
Unauthorized |
|||
|
500 |
Internal Server Error |
|||
|
getAgents |
agents |
GET |
200 |
OK |
|
400 |
Bad Request |
|||
|
401 |
Unauthorized |
|||
|
500 |
Internal Server Error |
|||
|
getBatteryQualifications |
battery_qualifications |
GET |
200 |
OK |
|
400 |
Bad Request |
|||
|
401 |
Unauthorized |
|||
|
500 |
Internal Server Error |
|||
|
getConsignPreferences |
consign_preference |
GET |
200 |
OK |
|
401 |
Unauthorized |
|||
|
500 |
Internal Server Error |
|||
|
getDropoffSites |
dropoff_sites |
GET |
200 |
OK |
|
401 |
Unauthorized |
|||
|
500 |
Internal Server Error |
|||
|
getHandoverSheet |
handover_sheet |
GET |
200 |
OK |
|
400 |
Bad Request |
|||
|
401 |
Unauthorized |
|||
|
404 |
Not found |
|||
|
500 |
Internal Server Error |
|||
|
getPackagesByLineItemID |
package/{order_line_item_id}/item |
GET |
200 |
OK |
|
400 |
Bad Request |
|||
|
401 |
Unauthorized |
|||
|
404 |
Not found |
|||
|
500 |
Internal Server Error |
|||
|
getLabels |
labels |
GET |
200 |
OK |
|
400 |
Bad Request |
|||
|
401 |
Unauthorized |
|||
|
404 |
Not found |
|||
|
500 |
Internal Server Error |
|||
|
getPackage |
package/{package_id} |
GET |
200 |
OK |
|
400 |
Bad Request |
|||
|
401 |
Unauthorized |
|||
|
404 |
Not found |
|||
|
500 |
Internal Server Error |
|||
|
getServices |
services |
GET |
200 |
OK |
|
400 |
Bad Request |
|||
|
401 |
Unauthorized |
|||
|
404 |
Not found |
|||
|
500 |
Internal Server Error |
|||
|
getTracking |
tracking |
GET |
200 |
OK |
|
400 |
Bad Request |
|||
|
401 |
Unauthorized |
|||
|
404 |
Not found |
|||
|
500 |
Internal Server Error |
|||
|
clonePackage |
package/{package_id}/clone |
POST |
201 |
Created |
|
400 |
Bad Request |
|||
|
401 |
Unauthorized |
|||
|
404 |
Not found |
|||
|
500 |
Internal Server Error |
|||
|
createBundle |
bundle |
POST |
201 |
Created |
|
400 |
Bad Request |
|||
|
401 |
Unauthorized |
|||
|
500 |
Internal Server Error |
|||
|
cancelBundle |
bundle/{bundle_id}/cancel |
POST |
204 |
No Content |
|
400 |
Bad Request |
|||
|
401 |
Unauthorized |
|||
|
500 |
Internal Server Error |
|||
|
getBundleLabel |
bundle/{bundle_id}/label |
GET |
200 |
OK |
|
400 |
Bad Request |
|||
|
401 |
Unauthorized |
|||
|
500 |
Internal Server Error |
|||
|
getBundle |
bundle/{bundle_id} |
GET |
200 |
OK |
|
400 |
Bad Request |
|||
|
401 |
Unauthorized |
|||
|
500 |
Internal Server Error |
（3）Error code 明细表
附表为最新HTTP code 对应的Error code list，供参考。
2025年9月22日
