游戲幣贈(zèng)送接口

2020-02-15 00:48 更新
本接口應(yīng)在后端服務(wù)器調(diào)用

給用戶贈(zèng)送游戲幣。開通小游戲支付后，可以通過該接口贈(zèng)送游戲幣給某個(gè)用戶。接口調(diào)用異常，可以通過相同的訂單號(hào)再次請(qǐng)求該接口，不會(huì)重復(fù)獎(jiǎng)勵(lì)。

POST https://developer.toutiao.com/api/apps/game/wallet/add_coin


請(qǐng)求參數(shù)

屬性類型默認(rèn)值是否必填說明
openidstring是用戶唯一標(biāo)識(shí)
appidstring是小程序唯一標(biāo)識(shí)
offer_idstring否擴(kuò)展字段，目前未使用，可不填
tsnumber是UNIX 時(shí)間戳，單位秒
zone_idstring是游戲服務(wù)器大區(qū) id，游戲不分大區(qū)則默認(rèn)填寫"1"。如果應(yīng)用支持多角色，則角色 ID 接在分區(qū) ID 后，用"_"連接
pfstring是平臺(tái) 安卓：android
user_ipstring否用戶外網(wǎng) IP
bill_nostring是訂單號(hào)，業(yè)務(wù)需要保證全局唯一。相同的訂單號(hào)不會(huì)重復(fù)扣款。長(zhǎng)度不超過 63，只能是數(shù)字、大小寫字母_-
present_countsnumber是贈(zèng)送游戲幣的個(gè)數(shù)，不能為 0
sigstring否擴(kuò)展字段，目前未使用，可不填
access_tokenstring是身份驗(yàn)證
mp_sigstring是支付簽名,本次請(qǐng)求的所有非空參數(shù)+uri+支付密鑰，用 HMAC-SHA256 簽名


返回值

Object ，包含以下屬性

屬性類型說明
errcodenumber錯(cuò)誤碼
errmsgstring錯(cuò)誤信息
balancenumber贈(zèng)送后的余額
bill_nostring贈(zèng)送游戲幣的訂單號(hào)

err_no 值類型

值說明
0請(qǐng)求成功
-1系統(tǒng)繁忙，此時(shí)請(qǐng)開發(fā)者稍候再試
90009mp_sig 簽名錯(cuò)誤
90010用戶未登錄或登錄態(tài)已過期
90011sig 簽名錯(cuò)誤
90012訂單已存在
90017沒有調(diào)用接口的權(quán)限
90018參數(shù)錯(cuò)誤


POST 數(shù)據(jù)格式：JSON

{
  "openid": "jjiemnnuyiopqmpvmmiji",
  "appid": "tt899008766",
  "ts": 1507530737,
  "zone_id": "1",
  "pf": "android",
  "present_counts": 123,
  "bill_no": "89jjnjkkmmku939",
  "mp_sig": "39271a12d8d56b0395981a0990a9e75ae239c54f419cb6235399fe70acf8ccfb",
  "access_token": "hds2rt6bhgh5wfg5nf4gdh6"
}
以上內(nèi)容是否對(duì)您有幫助：
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)