API Reference
English

送礼

事件类别:send_gift

  • send_gift[* Object SendGift]:送礼信息
    • receiving_account_id[* String]:收礼人账户 ID
    • gifts[* Array Merchandise]:礼物列表
      • merchandise_id[* String]:商品 ID
      • category_1[* String]:商品一级类目
      • category_2[String]:商品二级类目
      • category_3[String]:商品三级类目
      • name[String]:商品名称
      • count[Integer]:商品数量
      • unit_price[Object Amount]:商品单价
        • currency[* String]:原始金额货币类型,3 字母编码,符合 ISO 4217 标准
        • amount_local[* Double]:原始金额
        • amount_usd[Double]:金额(美金),将原始金额经过汇率换算后的美金金额,(条件必须:如果接入的是非 CN 站点则必须)
        • amount_cny[Double]:金额(人民币),将原始金额经过汇率换算后的人民币金额,(条件必须:如果接入的是 CN 站点则必须)
    • total_price_amount[* Object Amount]:礼物总价金额
      • currency[* String]:原始金额货币类型,3 字母编码,符合 ISO 4217 标准
      • amount_local[* Double]:原始金额
      • amount_usd[Double]:金额(美金),将原始金额经过汇率换算后的美金金额,(条件必须:如果接入的是非 CN 站点则必须)
      • amount_cny[Double]:金额(人民币),将原始金额经过汇率换算后的人民币金额,(条件必须:如果接入的是 CN 站点则必须)
    • scene_object_id[* String]:场景对象 ID,房间 ID 或会话 ID 等
    • scene[* String]:场景,枚举值
      • live_room:直播间
      • voice_room:语音房
      • chat_room:聊天室
      • chat:单聊
      • other:其它
{
    "send_gift": {
        "receiving_account_id": "5763543",
        "gifts": [
            {
                "merchandise_id": "NFH837824432",
                "category_1": "3c",
                "category_2": "phone",
                "category_3": "android",
                "name": "huawei phone",
                "count": 1,
                "amount": {
                    "currency": "CNY",
                    "amount_local": 6800,
                    "amount_usd": 1000,
                    "amount_cny": 6800
                }
            }
        ],
        "total_price_amount": {
            "currency": "CNY",
            "amount_local": 6800,
            "amount_usd": 1000,
            "amount_cny": 6800
        },
        "scene_object_id": "NDUH9364",
        "scene": "live_room"
    }
}