# 财务对账数据接入规范【黄金审计】
## 第一章 概述
**财务对账**
数据中心财务对账是为了确保财务入账的充值和消耗数据正确，目前从两个方面保证，一是核查游戏内充值用户钻石产销存相关数据；二是比对计费数据、SDK数据、GM后台各数据源充值相关数据之间的差异。财务对账需要接入以下两部分数据
· 黄金审计数据
· 黄金消耗明细日志
**黄金审计数据**
数据统一为北京时间，粒度为游戏、天、运营商、服务器，统计对象仅为各游戏充值用户（付费用户）的充值、赠送、消耗、非专充及期初期末留存黄金数。
**黄金消耗明细日志**
玩家黄金消耗的详细日志，用于财务审计
## **第二章** **财务黄金审计接口**
**接口定义**
1.传输协议: HTTP
2.请求方式: POST
3.请求地址:
o 内网地址：http://ba.youzu.com/api/datafeed/goldcheck?sign=SIGN
o 外网地址：http://ba-public.youzu.com/api/datafeed/goldcheck?sign=SIGN
4.请求包体:
o 格式: JSON
样例:
`{`
`" row_cnt ": 2,`
`"game_id": 135,`
`"date": "2016-01-01",`
`"author": "zhaoyun",`
`"rows": [{`
`"op_id": "2201",`
`"server_id": "1232",`
`"frequency": "day",`
`"intial_gold": 10000,`
`"excharge_gold": 1000,`
`"gift_gold": 1000,`
`"consume_gold": 1000,`
`"extra_gold": 1000,`
`"final_gold": 1000`
`}, {`
`"op_id": "2201",`
`"server_id": "1232",`
`"frequency": "day",`
`"intial_gold": 10000,`
`"excharge_gold": 1000,`
`"gift_gold": 1000,`
`"consume_gold": 1000,`
`"extra_gold": 1000,`
`"final_gold": 1000`
`}]`
`}`
**参数说明**
| 参数 | 描述 | 必输项 | 类型 | 说明 |
| ------------- | ---------------------------------------------------------- | ------ | ------ | ------------------------------------------------------------ |
| row_cnt | 记录数 | 是 | int | 传输的记录数, 等同于服务器数量。必须与rows中的记录行数相同 |
| date | 日期 | 是 | string | 格式: yyyy-MM-dd 2016-01-01 |
| game_id | 游戏id | 是 | int | 135 |
| op_id | 运营商id | 是 | string | 运营商id |
| server_id | 服务器id | 是 | string | 服务器id |
| frequency | 标明是每日黄金审计或每月黄金审计数据 | 是 | string | 数据范围:day、month |
| intial_gold | 上个月或昨日期末的所有充值玩家的存量黄金数 | 是 | int | 1000 |
| excharge_gold | 当月或当日充值的黄金数 | 是 | int | 1000 |
| gift_gold | 当月或当日赠送的黄金数 | 是 | int | 1000 |
| consume_gold | 截止本月底或本日所有充值玩家在当月的黄金消耗数 | 是 | int | 1000 |
| extra_gold | 本月或本日从非付费玩家变为付费玩家在月初或昨日的存量黄金数 | 是 | int | 1000 |
| final_gold | 本月底或当日所有充值玩家的存量黄金数 | 是 | int | 1000 |
| author | 录入人 | 是 | string | 填写公司邮箱@前的姓名缩写。例如，邮箱为zhaoyun@youzu.com，则该字段填入zhaoyun |
| sign | 记录签名 | 是 | string | 该字段无需放入请求包体，紧随访问地址，以get形式传入。计算方式，详见说明① |
说明① sign计算方式：
1) 在请求体的末尾拼上数据中心提供的KEY，进行SHA-1加密
比如：请求体是{"row_cnt":1,"date":"2020-03-16","game_id":374,"author":"abc@yoozoo.com","rows":[{"op_id":"1","server_id":"1","frequency":"day","intial_gold":0,"excharge_gold":0,"gift_gold":0,"consume_gold":0,"extra_gold":0,"final_gold":0}]}，key是12345678，则对字符串：
{"row_cnt":1,"date":"2020-03-16","game_id":374,"author":"abc@yoozoo.com","rows":[{"op_id":"1","server_id":"1","frequency":"day","intial_gold":0,"excharge_gold":0,"gift_gold":0,"consume_gold":0,"extra_gold":0,"final_gold":0}]}12345678 进行加密。
2) 将加密后的字符转换为大写，填入sign字段返回说明JSON格式
{"retcode":"00"，"retmsg":"数据传输成功"}
**字段说明**
| 参数 | 说明 |
| ------- | ------------------------------------------------------------ |
| retcode | 请求返回值。00表示成功, 其余均为失败 |
| retmsg | 返回描述。字典值如下： 01- 签名有误 02- 参数记录有误，请与数据中心联系！ 03- 字段不符合输入要求，以及具体说明 04- 传输记录行数与预期不符 |
## **第三章** **黄金消耗明细日志**
接入规范见 《数据中心标准生态日志》中RoleGold