艺天下开放平台

Appearance

本页目录

消息和事件推送 ​

第一步 验证消息的确来自艺天下服务器 ​

开发者提交应用的消息推送URl信息后，每当有拍品相关事件艺天下服务器将发送POST请求到填写的消息推送地址URL上，POST请求携带参数如下表所示：

参数必填说明
appid是appid
timestamp是时间戳
nonce是随机字符串
sign是加密签名，sign结合了开发者填写的token参数和请求中的timestamp参数、nonce参数。
data是业务数据参数
type是数据类型

开发者通过检验 sign 对请求进行校验（下面有校验方式）。确认请求来自艺天下服务器 加密/校验与请求Api签名方法一致

第二步 接收消息和事件 ​

当某些特定的操作引发事件推送时（如用户出价时），艺天下服务器会将消息（或事件）的数据包以 POST 请求发送到应用配置的 URL，开发者可以依据自身业务逻辑进行响应。

服务器收到请求必须做出下述：直接回复success

公共请求参数说明 ​

参数必填说明
appid是appid
nonce是随机字符串
timestamp是请求时间（秒）
sign是签名
type是事件类型
data是业务参数

同步拍品信息事件 auction_data ​

当在云代拍的专场列表拉取数据时，艺天下服务器会把这个事件推送到应用URL

完整消息示例

json
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "auction_data",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "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
      },
      "currency": "CNY"
    },
    "auction_list": [
      {
        "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": 4,
        "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
          }
        ]
      }
    ],
    "venue_info": {
      "venue_id": 4912,
      "venue_name": "保利秋季在线拍卖会",
      "venue_image": "http://dummyimage.com/100x100",
      "preview_start_time": 1585396800,
      "preview_end_time": 1620981612,
      "address_name": "北京大饭店"
    }
  }
}
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "auction_data",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "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
      },
      "currency": "CNY"
    },
    "auction_list": [
      {
        "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": 4,
        "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
          }
        ]
      }
    ],
    "venue_info": {
      "venue_id": 4912,
      "venue_name": "保利秋季在线拍卖会",
      "venue_image": "http://dummyimage.com/100x100",
      "preview_start_time": 1585396800,
      "preview_end_time": 1620981612,
      "address_name": "北京大饭店"
    }
  }
}

专场信息数据模型 ​

参数说明类型
album_id专场idint
album_name专场名称string
album_image专场封面图片string
start_time开始时间 （时间戳 秒）int
end_time结束时间 （时间戳 秒）int
album_type专场类型 1限时拍 2即时拍 3同步拍 4即刻拍int
auction_num拍品数量int
album_status专场状态 1未开始 2进行中 3已结束int
reset_time重置时间逗号分隔（120，10）最后120秒内出价延时10秒string
is_live是否直播 0不直播 1直播int
bond_type保证金类型 1固定金额 2比例保证金int
bond_price固定保证金金额 单位：元（bond_type为1生效）float
bond_bid_ratio出价抵扣比例 1:10 (bond_type为2生效)int
bond_status保证金状态 0 未缴纳 1免保证金int
commission佣金配置佣金数据模型
currency货币类型 CNY人民币 HKD港币 JPY日元 TWD台币 USD美元 EUR欧元 GBP英镑 CAD加元 AUD澳元string

佣金数据模型 ​

参数说明类型
commission_ratio佣金（百分比）float
commission_time佣金时间（秒级时间戳）int
after_commission_ratio到佣金时间之后的比例float

拍品信息数据模型 ​

参数说明类型
auction_id拍品idint
auction_name拍品名称string
auction_image拍品封面图片string
auction_status拍品状态 1进行中 2 预展中 3拍品结束有保留价待确认 4 流拍 5成交int
auction_slider_image拍品轮播图list
start_time开始时间 （时间戳 秒）int
end_time结束时间 （时间戳 秒）int
start_price起拍价格float
plus_price加价幅度float
top_price封顶价格float
retain_price保留价格float
time_status时间状态 1预展中 2进行中 3拍品结束int
lot图录号float
sort排序（从小到大）int
album_id专场idint
bond_price单件拍品保证金(单位 元)float
bid_type出价规则 1固定幅度 2竞价阶梯float
bid_range竞价阶梯array 竞价阶梯数据模型
old_auction_id重新上拍复用的拍品id（只有添加拍品事件会携带此参数）int

竞价阶梯数据模型 ​

参数说明类型
min阶梯最小金额string
max阶梯最大金额 （∞为无穷大）string
price固定加价金额（当type为1时生效）float
type阶梯类型 1 固定加价金额 2 2580 3 三位2580int

拍卖会信息数据模型 ​

参数说明类型
venue_id拍卖会idint
venue_name拍卖会名称string
venue_image拍卖会图片string
preview_start_time预展开始时间int
preview_end_time预展结束时间int
address_name拍卖会地址string

专场开始事件 album_start ​

当专场开始时，艺天下服务器会把这个事件推送到应用URL

完整消息示例

json
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "album_start",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "album_id": 1,
    "start_time": 1694603924
  }
}
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "album_start",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "album_id": 1,
    "start_time": 1694603924
  }
}

参数说明

参数说明类型
album_id专场idint
start_time开始时间int

专场结束事件 album_end ​

当专场结束时，艺天下服务器会把这个事件推送到应用URL

完整消息示例

json
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "album_end",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "album_id": 1,
    "end_time": 1694603924
  }
}
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "album_end",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "album_id": 1,
    "end_time": 1694603924
  }
}

参数说明

参数说明类型
album_id专场idint
end_time结束时间int

专场数据更新事件 album_data_update ​

当专场数据发送修改时，艺天下服务器会把这个事件推送到应用URL

完整消息示例

json
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "album_data_update",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "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,
    "commission": {
      "commission_ratio": 10,
      "commission_time": 0,
      "after_commission_ratio": 0
    },
    "currency": "CNY",
    "auction": [
      {
        "auction_id": 15,
        "start_time": 1637740800,
        "end_time": 1637740800
      }
    ]
  }
}
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "album_data_update",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "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,
    "commission": {
      "commission_ratio": 10,
      "commission_time": 0,
      "after_commission_ratio": 0
    },
    "currency": "CNY",
    "auction": [
      {
        "auction_id": 15,
        "start_time": 1637740800,
        "end_time": 1637740800
      }
    ]
  }
}

专场的拍品排序更新事件 album_auction_sort_update ​

当专场下的拍品排序发生改变时，艺天下服务器会把这个事件推送到应用URL

完整消息示例

json
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "album_auction_sort_update",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "album_id": 1,
    "auction": [
      {
        "auction_id": 15,
        "start_time": 1637740800,
        "end_time": 1637740800,
        "sort": 1
      }
    ]
  }
}
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "album_auction_sort_update",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "album_id": 1,
    "auction": [
      {
        "auction_id": 15,
        "start_time": 1637740800,
        "end_time": 1637740800,
        "sort": 1
      }
    ]
  }
}

参数说明

拍品数据添加事件 auction_data_add ​

当拍品数据发送修改时，艺天下服务器会把这个事件推送到应用URL

完整消息示例

json
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "album_data_add",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "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": 4,
    "time_status": 3,
    "lot": 16,
    "sort": 16,
    "album_id": 1,
    "bond_price": 0,
    "bid_type": 2,
    "old_auction_id": 0,
    "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
      }
    ]
  }
}
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "album_data_add",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "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": 4,
    "time_status": 3,
    "lot": 16,
    "sort": 16,
    "album_id": 1,
    "bond_price": 0,
    "bid_type": 2,
    "old_auction_id": 0,
    "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
      }
    ]
  }
}

参数说明

拍品数据更新事件 auction_data_update ​

当拍品数据发送修改时，艺天下服务器会把这个事件推送到应用URL

完整消息示例

json
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "auction_data_update",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "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": 4,
    "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
      }
    ]
  }
}
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "auction_data_update",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "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": 4,
    "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
      }
    ]
  }
}

参数说明

拍品开始事件 auction_start ​

当已同步的拍品到达开始时间后，艺天下服务器会把这个事件推送到应用URL

完整消息示例

json
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "auction_start",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "album_id": 1,
    "auction_id": 1,
    "start_time": 1637740800,
    "start_price": 100
  }
}
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "auction_start",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "album_id": 1,
    "auction_id": 1,
    "start_time": 1637740800,
    "start_price": 100
  }
}

参数说明

参数说明类型
album_id专场idint
auction_id拍品idint
start_time开始时间int
start_time起拍价int

拍品结束事件 auction_end ​

当已同步的拍品到达结束时间后，艺天下服务器会把这个事件推送到应用URL

完整消息示例

json
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "auction_end",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "album_id": 1,
    "auction_id": 1,
    "end_time": 1637740800,
    "auction_status": 5,
    "bid_id": 1,
    "bid_price": 1000
  }
}
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "auction_end",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "album_id": 1,
    "auction_id": 1,
    "end_time": 1637740800,
    "auction_status": 5,
    "bid_id": 1,
    "bid_price": 1000
  }
}

参数说明

参数说明类型
album_id专场idint
auction_id拍品idint
end_time结束时间int
auction_status拍品状态 1进行中 2 预展中 3拍品结束有保留价待确认 4 流拍 5成交int
bid_id最后一次出价idint
bid_price拍品价格float

拍品保留价确认事件 auction_retain_confirm ​

当已结束的拍品被确认保留价后，艺天下服务器会把这个事件推送到应用URL

完整消息示例

json
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "auction_retain_confirm",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "album_id": 1,
    "auction_id": 1,
    "auction_status": 5,
    "bid_id": 1,
    "bid_price": 1000
  }
}
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "auction_retain_confirm",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "album_id": 1,
    "auction_id": 1,
    "auction_status": 5,
    "bid_id": 1,
    "bid_price": 1000
  }
}

参数说明

参数说明类型
album_id专场idint
auction_id拍品idint
auction_status拍品状态 1进行中 2 预展中 3拍品结束有保留价待确认 4 流拍 5成交int
bid_id最后一次出价idint
bid_price拍品价格float

拍品出价事件 bid_price ​

当已同步的拍品到达结束时间后，艺天下服务器会把这个事件推送到应用URL

完整消息示例

json
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "bid_price",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "album_id": 1,
    "auction_id": 1,
    "bid_id": 154,
    "bid_price": 100,
    "is_confirm": 1,
    "end_time": 1637740800,
    "next_bid_price": 500,
    "source_type": 3,
    "source_platform_proxy_id": 12,
    "currency": "CNY"
  }
}
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "bid_price",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "album_id": 1,
    "auction_id": 1,
    "bid_id": 154,
    "bid_price": 100,
    "is_confirm": 1,
    "end_time": 1637740800,
    "next_bid_price": 500,
    "source_type": 3,
    "source_platform_proxy_id": 12,
    "currency": "CNY"
  }
}

参数说明

参数说明类型
album_id专场idint
auction_id拍品idint
bid_id出价唯一IDint
bid_price出价金额（单位元）float
is_confirm是否确认（0未确认1已确认（只有同步拍的拍品需要确认）-1出价被取消）int
end_time结束时间 （需要跟接入方系统的现有拍品时间对比判断是否一致，如果不一致则更新）int
next_bid_price下一口价格float
source_type出价来源 1网络出价 2 现场出价 3 代理平台出价int
source_platform_proxy_id代理平台idint
currency货币类型 CNY人民币 HKD港币 JPY日元 TWD台币 USD美元 EUR欧元 GBP英镑 CAD加元 AUD澳元string

拍品出价确认事件 bid_price_confirm ​

当拍卖师确认出价有效后，艺天下服务器会把这个事件推送到应用URL

  1. 只有同步拍会发送此事件
  2. 开发者需要根据bid_id参数确认出价信息

完整消息示例

json
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "bid_price_confirm",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "album_id": 1,
    "auction_id": 1,
    "bid_id": 154,
    "status": 1
  }
}
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "bid_price_confirm",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "album_id": 1,
    "auction_id": 1,
    "bid_id": 154,
    "status": 1
  }
}

参数说明

参数说明类型
album_id专场idint
auction_id拍品idint
bid_id出价唯一IDint
status确认状态 1确认出价 -1出价无效int

拍品重拍事件 auction_remake ​

当拍品重新拍卖时，艺天下服务器会把这个事件推送到应用URL

  1. 只有同步拍会发送此事件
  2. 只有专场当前没有进行中的拍品才会触发此事件
  3. 开发者需要根据bid_id参数确认出价信息
  4. 如果after_auction_id有值 auction_id插入到指定after_auction_id的后面
  5. 如果is_jump=1 auction_id跳转到当前待开拍的拍品前面

完整消息示例

json
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "auction_remake",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "album_id": 1,
    "auction_id": 1,
    "after_auction_id": 154,
    "is_jump": 0
  }
}
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "auction_remake",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "album_id": 1,
    "auction_id": 1,
    "after_auction_id": 154,
    "is_jump": 0
  }
}

参数说明

参数说明类型
album_id专场idint
auction_id拍品idint
after_auction_id插入到指定拍品ID后面拍卖int
is_jump是否跳拍（0不是 1是）int

拍品删除出价事件 auction_delbidprice ​

当拍品的最高出价被删除时，艺天下服务器会把这个事件推送到应用URL

  1. 只有同步拍会发送此事件
  2. 只有拍品的最高价可以删除

完整消息示例

json
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "auction_delbidprice",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "album_id": 1,
    "auction_id": 1,
    "bid_id": 21,
    "next_bid_id": 12
  }
}
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "auction_delbidprice",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "album_id": 1,
    "auction_id": 1,
    "bid_id": 21,
    "next_bid_id": 12
  }
}

参数说明

参数说明类型
album_id专场idint
auction_id拍品idint
bid_id出价id（删除的出价记录id）int
next_bid_id下一口出价id（删除后的最高价记录id）int

拍品撤拍事件 auction_revoke ​

当拍品被撤拍时，艺天下服务器会把这个事件推送到应用URL

  1. 只有同步拍会发送此事件

完整消息示例

json
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "auction_revoke",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "album_id": 1,
    "auction_id": 1
  }
}
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "auction_revoke",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "album_id": 1,
    "auction_id": 1
  }
}

参数说明

参数说明类型
album_id专场idint
auction_id拍品idint

拍品订单发货 order_delivery ​

当拍品订单发货时，艺天下服务器会把这个事件推送到应用URL

完整消息示例

json
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "order_delivery",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "album_id": 1,
    "auction_id": 1,
    "delivery_type": 1,
    "delivery_id": "SF1041184111",
    "delivery_name": "顺丰快递"
  }
}
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "order_delivery",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "album_id": 1,
    "auction_id": 1,
    "delivery_type": 1,
    "delivery_id": "SF1041184111",
    "delivery_name": "顺丰快递"
  }
}

参数说明

参数说明类型
album_id专场idint
auction_id拍品idint
delivery_type运输方式 1快递 2买家自提 3 委托他人自提int
delivery_id快递单号string
delivery_name快递公司string

拍品订单取消 order_cancel ​

当拍品订单被取消时，艺天下服务器会把这个事件推送到应用URL

完整消息示例

json
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "order_cancel",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "album_id": 1,
    "auction_id": 1,
    "cancel_type": 1,
    "bond_deduct_price": 500
  }
}
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "order_cancel",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "album_id": 1,
    "auction_id": 1,
    "cancel_type": 1,
    "bond_deduct_price": 500
  }
}

参数说明

参数说明类型
album_id专场idint
auction_id拍品idint
cancel_type取消类型 1 扣除保证金 2 解冻保证金int
bond_deduct_price保证金扣除金额float

修改拍品竞价规则 auction_edit_bidRange ​

当拍品修改竞价规则时，艺天下服务器会把这个事件推送到应用URL

完整消息示例

json
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "yISTQn",
  "type": "auction_edit_bidRange",
  "data": {
    "album_id": 27676,
    "auction_id": 881788,
    "bid_type": 2,
    "plus_price": 0,
    "bid_range": [
      {
        "min": "0",
        "max": "∞",
        "price": 20000,
        "type": 1
      }
    ]
  },
  "sign": "49B0010A7991CD8102A8824B1389BF45"
}
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "yISTQn",
  "type": "auction_edit_bidRange",
  "data": {
    "album_id": 27676,
    "auction_id": 881788,
    "bid_type": 2,
    "plus_price": 0,
    "bid_range": [
      {
        "min": "0",
        "max": "∞",
        "price": 20000,
        "type": 1
      }
    ]
  },
  "sign": "49B0010A7991CD8102A8824B1389BF45"
}

参数说明

参数说明类型
album_id专场idint
auction_id拍品idint
bid_type出价规则 1固定幅度 2竞价阶梯int
plus_price加价幅度float
bid_range竞价阶梯array 竞价阶梯数据模型

直播流状态改变事件 live_stream_status ​

当直播的推流状态发生改变时，艺天下服务器会把这个事件推送到应用URL

完整消息示例

json
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "yISTQn",
  "type": "live_stream_status",
  "data": {
    "album_id": 27676,
    "live_id": 1,
    "status": 1
  },
  "sign": "49B0010A7991CD8102A8824B1389BF45"
}
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "yISTQn",
  "type": "live_stream_status",
  "data": {
    "album_id": 27676,
    "live_id": 1,
    "status": 1
  },
  "sign": "49B0010A7991CD8102A8824B1389BF45"
}

参数说明

参数说明类型
album_id专场idint
live_id直播idint
status0直播断流 1直播推流中 2直播推流地址更新（请求获取专场直播播放地址更新推流地址）int

修改竞价阶梯 edit_bidRange ​

当商户修改竞价阶梯时，艺天下服务器会把这个事件推送到应用URL

完整消息示例

json
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "yISTQn",
  "type": "edit_bidRange",
  "data": {
    "auction_list": [
      {
        "album_id": 1,
        "auction_id": 2
      }
    ],
    "bid_range": [
      {
        "min": "0",
        "max": "∞",
        "price": 20000,
        "type": 1
      }
    ]
  },
  "sign": "49B0010A7991CD8102A8824B1389BF45"
}
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "yISTQn",
  "type": "edit_bidRange",
  "data": {
    "auction_list": [
      {
        "album_id": 1,
        "auction_id": 2
      }
    ],
    "bid_range": [
      {
        "min": "0",
        "max": "∞",
        "price": 20000,
        "type": 1
      }
    ]
  },
  "sign": "49B0010A7991CD8102A8824B1389BF45"
}

参数说明

参数说明类型
auction_list要修改的拍品列表array
bid_range竞价阶梯array 竞价阶梯数据模型

批量删除拍品 auction_batch_delete ​

当商户批量删除拍品时，艺天下服务器会把这个事件推送到应用URL

完整消息示例

json
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "yISTQn",
  "type": "auction_batch_delete",
  "data": {
    "album_id": 1,
    "auction_ids": [
      1,
      2,
      3
    ]
  },
  "sign": "49B0010A7991CD8102A8824B1389BF45"
}
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "yISTQn",
  "type": "auction_batch_delete",
  "data": {
    "album_id": 1,
    "auction_ids": [
      1,
      2,
      3
    ]
  },
  "sign": "49B0010A7991CD8102A8824B1389BF45"
}

参数说明

参数说明类型
album_id专场idint
auction_ids删除的拍品idarray

批量添加拍品 auction_batch_add ​

当在商户批量添加拍品时，艺天下服务器会把这个事件推送到应用URL

完整消息示例

json
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "auction_batch_add",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "album_id": 1548,
    "auction_list": [
      {
        "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": 4,
        "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
          }
        ]
      }
    ]
  }
}
{
  "appid": "DeBk",
  "timestamp": 1694603924,
  "nonce": "fFChqz",
  "type": "auction_batch_add",
  "sign": "1F1CE68FFBC4E677B13629037915CBB3",
  "data": {
    "album_id": 1548,
    "auction_list": [
      {
        "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": 4,
        "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
          }
        ]
      }
    ]
  }
}

Released under the MIT License.

Copyright © 2023-present chaind