京东服务+
  1. 商品接口
京东服务+
  • 接口安全
  • 业务流程
  • 订单回调
  • 接口注意事项
  • 商品接口
    • 京东商品分类
      GET
    • 商品列表
      GET
    • 商品详情
      GET
    • 日历接口
      POST
  • 订单接口
    • 订单详情
      GET
    • 商品下单
      POST
    • 客服链接
      GET
    • 订单服务进度
      GET
    • 退单
      POST
  • 渠道账号
    • 账户余额
      GET
  1. 商品接口

日历接口

POST
/api/goods/dates
商品接口
日历接口

请求参数

Query 参数
appId
string 
渠道ID
必需
nonce
string 
随机字符串
必需
sign
string 
签名
必需
timestamp
string 
时间戳
必需
Body 参数application/json
customerAddressList
array[object (用户地址) {4}] 
用户地址
必需
addressType
integer <int32>
可选
1取件地址 2收货地址
contactName
string 
联系人名称
可选
contactPhone
string 
联系人电话
可选
customerAddress
string 
地址
可选
date
string 
指定日期
可选
示例值:
2024-01-01
goodsId
string 
商品id
必需
itemId
string 
商品套餐id
必需
示例
{
  "customerAddressList": [
    {
      "addressType": 0,
      "contactName": "string",
      "contactPhone": "string",
      "customerAddress": "string"
    }
  ],
  "date": "2024-01-01",
  "goodsId": "string",
  "itemId": "string"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/api/goods/dates?appId=&nonce=&sign=&timestamp=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "customerAddressList": [
        {
            "addressType": 0,
            "contactName": "string",
            "contactPhone": "string",
            "customerAddress": "string"
        }
    ],
    "date": "2024-01-01",
    "goodsId": "string",
    "itemId": "string"
}'

返回响应

🟢200OK
application/json
Body
array of:
available
boolean 
是否可预约
可选
date
string 
可选
日期 格式:yyyy-MM-dd
serviceTimeSlotList
array[object (DateRange) {3}] 
服务时间
可选
available
boolean 
可选
begin
string <date-time>
服务开始时间
可选
end
string <date-time>
服务结束时间
可选
示例
[
  {
    "available": true,
    "date": "string",
    "serviceTimeSlotList": [
      {
        "available": true,
        "begin": "2019-08-24T14:15:22Z",
        "end": "2019-08-24T14:15:22Z"
      }
    ]
  }
]
🟢201Created
🟠401Unauthorized
🟠403Forbidden
🟠404Not Found
上一页
商品详情
下一页
订单详情
Built with