返回之前创建过 royalty 对象的一个列表。列表是按创建时间进行排序,总是将最新的 royalty 对象显示在最前。
| 请求参数 | 描述 |
|---|---|
| payer_app string optional | 分润发起方对应的 app 对象的 id。 |
| recipient_app string optional | 分润接收方 user 关联的 app 对象的 id。 |
| source_app string optional | 平台的 app 对象的 id。 |
| source_no string optional | 关联订单对象的 merchant_order_no,用于获取指定订单所有的分润和退分润对象。不能和 source_nos 同时使用。 |
| source_nos array optional | 关联订单对象的 merchant_order_no 列表,用于获取指定订单所有的分润和退分润对象。最多可填写 200 个元素。不能和 source_no 同时使用。 |
| source_user string optional | 分润接收方 user 对象的 id。 |
| status string optional | 分润状态。值为 created:入账、pending:结算发起、waiting:结算汇总、succeeded:结算成功。 |
| royalty_settlement string optional | 关联的 royalty_settlement 对象的 id。 |
| royalty_transaction string optional | 关联的 royalty_transaction 对象的 id。 |
| page integer optional | 页码,默认值为 "1",取值范围(1~100000000)。 |
| per_page optional integer | 每页数量,默认值为 "10"。 |
| created[gt] optional timestamp | 创建时间大于该值,用 Unix 时间戳表示。 |
| created[gte] optional timestamp | 创建时间大于或等于该值,用 Unix 时间戳表示。 |
| created[lt] optional timestamp | 创建时间小于该值,用 Unix 时间戳表示。 |
| created[lte] optional timestamp | 创建时间小于或等于该值,用 Unix 时间戳表示。 |
返回
返回一个 royalty 对象,或者返回一个错误,详见 错误。
GET https://api.pingxx.com/v1/royalties
待补充
待补充
待补充
待补充
待补充
待补充
待补充
curl https://api.pingxx.com/v1/royalties \ -H "Pingplusplus-Request-Timestamp: 1475029155" \ -H "Pingplusplus-Signature: SIGNATURE" \ -u sk_test_ibbTe5jLGCi5rzfH4OqPW9KC:
待补充
待补充
待补充
待补充
待补充
待补充
待补充
{
"object": "list",
"url": "/v1/royalties",
"has_more": false,
"data": [
{
"id": "170301124238000111",
"object": "royalty",
"payer_app": "app_1Gqj58ynP0mHeX1q",
"amount": -1,
"created": 1488343358,
"description": "Your description",
"livemode": true,
"metadata": {},
"method": "manual",
"recipient_app": null,
"royalty_transaction": null,
"royalty_settlement": null,
"source_app": "app_1Gqj58ynP0mHeX1q",
"source_no": "12345678",
"source_url": "/v1/orders/2011609010000025991",
"source_user": "user_001",
"status": "succeeded",
"settle_account": null,
"time_settled": 1488465301
},
{...},
{...}
]
}