艺天下开放平台

Appearance

本页目录

接口列表 ​

生产环境API ​

http
https://cloud-api.yunzongbu.cn
https://cloud-api.yunzongbu.cn

请求说明 ​

  • 公共请求参数说明
参数必填说明
appid是appid
nonce是随机字符串
timestamp是请求时间（秒）
sign是签名
  • 响应status状态码
状态说明
200成功
400失败
403签名验证失败

拍品出价 ​

  • 请求 POST
http
api/proxyPlatformApp/auctionBid
api/proxyPlatformApp/auctionBid

参数说明

参数必填说明
auction_id是拍品id
bid_price是价格（单位元）
  • 响应
json
{
  "status": 200,
  "message": "出价成功",
  "data": {
    "bid_id": 1,
    "is_confirm": 1
  },
  "server_time": 1695275115
}
{
  "status": 200,
  "message": "出价成功",
  "data": {
    "bid_id": 1,
    "is_confirm": 1
  },
  "server_time": 1695275115
}

参数说明

参数必填说明
bid_id是出价id
is_confirm是否确认（0未确认1已确认（只有同步拍的拍品需要确认）-1出价被取消）int

错误返回样例：

json
{
  "status": 400,
  "message": "拍品状态异常",
  "server_time": 1695282946
}
{
  "status": 400,
  "message": "拍品状态异常",
  "server_time": 1695282946
}

获取专场直播播放地址 ​

  • 请求 POST ​

http
api/proxyPlatformApp/getAlbumLivePlayUrl
api/proxyPlatformApp/getAlbumLivePlayUrl

参数说明

参数必填说明
album_id是专场id
  • 响应
json
{
  "status": 200,
  "message": "出价成功",
  "data": {
    "play_url": {
      "rtmp": "rtmp://play-live.yunzongbu.cn/live/123145?txSecret=8c0c1eed93a7fa930d962cfcf052d5b0cf&txTime=650EA05D",
      "flv": "http://play-live.yunzongbu.cn/live/123145.flv?txSecret=8c30c1e2ed9a7fa390d962cfcf052d5b0cf&txTime=650EA05D",
      "hls": "http://play-live.yunzongbu.cn/live/123145.m3u8?txSecret=8c0c1eed92a7fa590d962cfcf052d5b0cf&txTime=650EA05D",
      "webrtc": "webrtc://play-live.yunzongbu.cn/live/123145?txSecret=8c0c13eed9a7fa590d962cfcf052d5b0cf&txTime=650EA05D"
    },
    "expire_time": 1695457493
  },
  "server_time": 1695284693
}
{
  "status": 200,
  "message": "出价成功",
  "data": {
    "play_url": {
      "rtmp": "rtmp://play-live.yunzongbu.cn/live/123145?txSecret=8c0c1eed93a7fa930d962cfcf052d5b0cf&txTime=650EA05D",
      "flv": "http://play-live.yunzongbu.cn/live/123145.flv?txSecret=8c30c1e2ed9a7fa390d962cfcf052d5b0cf&txTime=650EA05D",
      "hls": "http://play-live.yunzongbu.cn/live/123145.m3u8?txSecret=8c0c1eed92a7fa590d962cfcf052d5b0cf&txTime=650EA05D",
      "webrtc": "webrtc://play-live.yunzongbu.cn/live/123145?txSecret=8c0c13eed9a7fa590d962cfcf052d5b0cf&txTime=650EA05D"
    },
    "expire_time": 1695457493
  },
  "server_time": 1695284693
}

参数说明

参数必填说明
play_url是播放url
expire_time是url过期时间戳

拍品详情 ​

  • 请求 POST ​

http
api/proxyPlatformApp/auctionInfo
api/proxyPlatformApp/auctionInfo

参数说明

参数必填说明
album_id是专场id
auction_id是拍品id
  • 响应
json
{
  "status": 200,
  "message": "操作成功",
  "data": {
    "auction_info": {
      "auction_id": 3,
      "auction_name": "朱恒 山水《李白诗意图》",
      "auction_image": "http://dummyimage.com/100x100",
      "auction_slider_image": [
        "http://dummyimage.com/100x100",
        "http://dummyimage.com/100x100"
      ],
      "start_time": 1637740800,
      "end_time": 1637745480,
      "start_price": 1,
      "plus_price": 0,
      "top_price": 0,
      "retain_price": 0,
      "auction_status": 5,
      "time_status": 3,
      "lot": 16,
      "sort": 16,
      "album_id": 1,
      "bond_price": 0,
      "bid_type": 2,
      "bid_range": [
        {
          "min": "0",
          "max": "1000000",
          "price": 0,
          "type": 2
        },
        {
          "min": "1000000",
          "max": "10000000",
          "price": 100000,
          "type": 1
        },
        {
          "min": "10000000",
          "max": "∞",
          "price": 500000,
          "type": 1
        }
      ]
    },
    "dealBidInfo": {
      "bid_id": 3,
      "auction_id": 43,
      "bid_price": 1611
    }
  },
  "server_time": 1695284693
}
{
  "status": 200,
  "message": "操作成功",
  "data": {
    "auction_info": {
      "auction_id": 3,
      "auction_name": "朱恒 山水《李白诗意图》",
      "auction_image": "http://dummyimage.com/100x100",
      "auction_slider_image": [
        "http://dummyimage.com/100x100",
        "http://dummyimage.com/100x100"
      ],
      "start_time": 1637740800,
      "end_time": 1637745480,
      "start_price": 1,
      "plus_price": 0,
      "top_price": 0,
      "retain_price": 0,
      "auction_status": 5,
      "time_status": 3,
      "lot": 16,
      "sort": 16,
      "album_id": 1,
      "bond_price": 0,
      "bid_type": 2,
      "bid_range": [
        {
          "min": "0",
          "max": "1000000",
          "price": 0,
          "type": 2
        },
        {
          "min": "1000000",
          "max": "10000000",
          "price": 100000,
          "type": 1
        },
        {
          "min": "10000000",
          "max": "∞",
          "price": 500000,
          "type": 1
        }
      ]
    },
    "dealBidInfo": {
      "bid_id": 3,
      "auction_id": 43,
      "bid_price": 1611
    }
  },
  "server_time": 1695284693
}

参数说明

参数必填说明
auction_info是拍品信息数据模型
dealBidInfo否出价数据模型

出价数据模型 ​

参数说明类型
bid_id出价idint
auction_id拍品idstring
bid_price出价金额float

专场详情 ​

  • 请求 POST ​

http
api/proxyPlatformApp/albumInfo
api/proxyPlatformApp/albumInfo

参数说明

参数必填说明
album_id是专场id
  • 响应
json
{
  "status": 200,
  "message": "操作成功",
  "data": {
    "album_info": {
      "album_id": 1,
      "album_name": "青花瓷瓶专场（一）",
      "album_image": "http://dummyimage.com/100x100",
      "start_time": 1637740800,
      "end_time": 1637745480,
      "album_status": 3,
      "auction_num": 20,
      "album_type": 3,
      "reset_time": "60,100",
      "is_live": 0,
      "bond_type": 1,
      "bond_bid_ratio": 0,
      "bond_price": 10000,
      "bond_status": 1,
      "commission": {
        "commission_ratio": 10,
        "commission_time": 0,
        "after_commission_ratio": 0
      }
    },
    "dealBidInfo": {
      "bid_id": 3,
      "auction_id": 43,
      "bid_price": 1611
    }
  },
  "server_time": 1695284693
}
{
  "status": 200,
  "message": "操作成功",
  "data": {
    "album_info": {
      "album_id": 1,
      "album_name": "青花瓷瓶专场（一）",
      "album_image": "http://dummyimage.com/100x100",
      "start_time": 1637740800,
      "end_time": 1637745480,
      "album_status": 3,
      "auction_num": 20,
      "album_type": 3,
      "reset_time": "60,100",
      "is_live": 0,
      "bond_type": 1,
      "bond_bid_ratio": 0,
      "bond_price": 10000,
      "bond_status": 1,
      "commission": {
        "commission_ratio": 10,
        "commission_time": 0,
        "after_commission_ratio": 0
      }
    },
    "dealBidInfo": {
      "bid_id": 3,
      "auction_id": 43,
      "bid_price": 1611
    }
  },
  "server_time": 1695284693
}

参数说明

参数必填说明
album_info是专场信息数据模型

订单支付 ​

  • 请求 POST ​

http
api/proxyPlatformApp/orderPay
api/proxyPlatformApp/orderPay

参数说明

参数必填说明
album_id是专场id
auction_id是拍品id
  • 响应
json
{
  "status": 200,
  "message": "支付成功",
  "data": {},
  "server_time": 1695284693
}
{
  "status": 200,
  "message": "支付成功",
  "data": {},
  "server_time": 1695284693
}

设置订单物流方式 ​

  • 请求 POST ​

http
api/proxyPlatformApp/setOrderDeliveryInfo
api/proxyPlatformApp/setOrderDeliveryInfo

参数说明

参数必填说明
album_id是专场id
auction_id是拍品id
delivery_type是物流方式 1 物流 2 自提
user_address是收货地址（查看物流url）
  • 响应
json
{
  "status": 200,
  "message": "设置成功",
  "data": {},
  "server_time": 1695284693
}
{
  "status": 200,
  "message": "设置成功",
  "data": {},
  "server_time": 1695284693
}

确认收货 ​

  • 请求 POST ​

http
api/proxyPlatformApp/orderReceived
api/proxyPlatformApp/orderReceived

参数说明

参数必填说明
album_id是专场id
auction_id是拍品id
  • 响应
json
{
  "status": 200,
  "message": "确认收货成功",
  "data": {},
  "server_time": 1695284693
}
{
  "status": 200,
  "message": "确认收货成功",
  "data": {},
  "server_time": 1695284693
}

设置拍品订单保证金 ​

  • 请求 POST ​

http
api/proxyPlatformApp/setAuctionBond
api/proxyPlatformApp/setAuctionBond

参数说明

参数必填说明
album_id是专场id
auction_id是拍品id
bond_price是保证金金额
  • 响应
json
{
  "status": 200,
  "message": "设置成功",
  "data": {},
  "server_time": 1695284693
}
{
  "status": 200,
  "message": "设置成功",
  "data": {},
  "server_time": 1695284693
}

拍品出价列表 ​

  • 请求 POST ​

http
api/proxyPlatformApp/auctionBidList
api/proxyPlatformApp/auctionBidList

参数说明

参数必填说明
album_id是专场id
auction_id是拍品id
  • 响应
json
{
  "status": 200,
  "message": "操作成功",
  "data": {
    "bidList": [
      {
        "bid_id": 1,
        "auction_id": 1641,
        "bid_price": 100
      }
    ]
  },
  "server_time": 1695284693
}
{
  "status": 200,
  "message": "操作成功",
  "data": {
    "bidList": [
      {
        "bid_id": 1,
        "auction_id": 1641,
        "bid_price": 100
      }
    ]
  },
  "server_time": 1695284693
}

参数说明

参数必填说明
bidList否出价数据模型

Released under the MIT License.

Copyright © 2023-present chaind