按需使用量推送（新）

接口说明

用户在云商店开通按需资源并产生使用量后，ISV需通过此接口返回用户的实际使用量话单，云商店获取话单后根据使用量计费并对用户扣费。

SDK请参考《获取SDK》。

如何获取AK/SK请参考《AK/SK认证说明》。

URI

POST https://mkt-intl.myhuaweicloud.com/api/mkp-openapi-public/global/v1/isv/usage-data（公网）

请求消息

请求参数说明请参见下表：

请求方法：POST

请求消息示例：

Post {domain}/api/mkp-openapi-public/global/v1/isv/usage-data 
Content-Type:application/json 
nonce: 6c63c221-1f6b-4141-8ff4-22f5dfe82b65 
ts: 1709690865879 
signature: gikLsIgimIscagwSamClFJ1CFT4QprHSDHW… 
{  
    "usage_records": [  
        {  
            "instance_id": "7f141bf1-aec8-4859-8323-fb3a8ad50721",  
            "record_time": "20220809T091000Z",  
            "begin_time": "20220809T080000Z",  
            "end_time": "20220809T090000Z",  
            "usage_value": "99", 
            "metering_sn": "6c75c177b5fe4b8cbb6fc2aa33facfcd"  
        },  
        {  
            "instance_id": "7f141bf1-aec8-4859-8323-fb3a8ad50721",   
            "record_time": "20220809T091000Z",  
            "begin_time": "20220809T080000Z",  
            "end_time": "20220809T090000Z",  
            "usage_value": "999", 
            "metering_sn": "6c75c177b5fe4b8cbb6fc2aa33facfcb" 
        }  
    ]  
}

1、接口调用上传时，如果话单数据异常，不会在接口层进行报错；后台定时任务会对上传的数据进行校验和处理，生成可以使用的话单数据。如果后台数据处理失败，需要商家重新进行上报。

异常数据可以在 “卖家中心＞交易管理＞话单管理” 进行查看！

2、话单上报周期要求：

• 按小时计费

  需要至少每小时上报一次话单数据，且最好在消费时间下一个小时的0-15分钟内完成上报，譬如，用户消费时间在13:25，最好在14:00-14:15内上报，这样能及时给用户扣费，否则就会出现扣费延迟，如果无法实现实时上报，需要在2小时完成上报

• 按天计费

  推荐每小时将已经明确的用量话单上报到云商店，如果必须每天汇总上报一次，需要保证必须在次日的00:00-00:15内完成上报，最大不能超过01:00，否则用户的扣费会延迟到下一天

3、话单数据上报要求：

• 资源未关闭：
• 话单开始时间（begin_time）≥资源开始时间
• 话单开始时间（begin_time）≤话单结束时间（end_time）≤ 话单上报时间
• 资源关闭后：
• 话单结束时间（end_time）≤资源关闭时间

4、话单上报中的时间为UTC 时间，与北京时间相差 8 小时；

5、同一个记录的时间，即begin_time 和end_time 时间都一致的情况下，如多次上报记录，会被识别为重复话单，只会处理第一条数据，一旦话单采集后形成正式账单将无法逆向错误话单（话单采集时间：按天计费为每天凌晨1点，按小时计费为每小时15分）。

重复话单将视为异常，异常数据可以在 “卖家中心＞交易管理＞话单管理” 进行查看！

6、使用量推送接口使用按需接口返回的实例ID，不能使用套餐包返回的实例ID。

响应消息

响应参数说明请参见下表：

错误码：

当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。

响应消息示例：

  
{  
   "error_code":"MKT.0000",  
   "error_msg":"Success"  
} 
  
{ 
    "error_code": "94060999", 
    "error_msg": "Failed", 
    "data": { 
        "abnormal_usage_data": [ 
            { 
                "error_code": "005", 
                "error_msg": "METERING_SN_DUPLICATE", 
                "metering_sn": "6c75c177b5fe4b8cbb6fc2aa33facfcb" 
            } 
        ] 
    } 
}