野象新媒体接口文档

新媒体对外接口文档


订单列表

<p>[TOC]</p> <h5>简要描述</h5> <ul> <li>采用游标分页方式获取订单列表</li> <li>订单列表按订单创建时间倒序排列</li> </ul> <p>[游标分页请求代码示例](<a href="https://www.showdoc.com.cn/gatewaypartnerv1/10914997007617396">https://www.showdoc.com.cn/gatewaypartnerv1/10914997007617396</a> &quot;游标分页请求代码示例&quot;)</p> <h5>请求URL</h5> <ul> <li><code>/order/list</code></li> </ul> <h5>请求方式</h5> <ul> <li>GET</li> </ul> <h5>参数</h5> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th style="text-align: left;">说明&amp;emsp;&amp;emsp;&amp;emsp;&amp;emsp;&amp;emsp;&amp;emsp;&amp;emsp;&amp;emsp;&amp;emsp;&amp;emsp;&amp;emsp;&amp;emsp;&amp;emsp;&amp;emsp;&amp;emsp;&amp;emsp;&amp;emsp;&amp;emsp;&amp;emsp;&amp;emsp;&amp;emsp;&amp;emsp;&amp;emsp;&amp;emsp;&amp;emsp;&amp;emsp;&amp;emsp;&amp;emsp;&amp;emsp;&amp;emsp;&amp;emsp;&amp;emsp;  </th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">appId    </td> <td style="text-align: left;">否  </td> <td style="text-align: left;">Long    </td> <td style="text-align: left;">应用 ID                                                                  </td> </tr> <tr> <td style="text-align: left;">beginDate</td> <td style="text-align: left;">否  </td> <td style="text-align: left;">String  </td> <td style="text-align: left;">订单创建开始时间,&lt;br/&gt;格式“yyyy-MM-dd HH:mm:ss”,&lt;/br&gt;例如:“2023-09-04 19:11:56”&lt;br/&gt;或者“yyyy-MM-dd”,&lt;/br&gt;例如:“2023-09-04”,&lt;br/&gt;<strong>注意包含开始时间</strong>   </td> </tr> <tr> <td style="text-align: left;">endDate  </td> <td style="text-align: left;">否  </td> <td style="text-align: left;">String  </td> <td style="text-align: left;">订单创建结束时间,&lt;br/&gt;格式“yyyy-MM-dd HH:mm:ss”,&lt;/br&gt;例如:“2023-09-04 19:11:56”&lt;br/&gt;或者“yyyy-MM-dd”,&lt;/br&gt;例如:“2023-09-04”,&lt;br/&gt;<strong>注意不包含结束时间</strong></td> </tr> <tr> <td style="text-align: left;">payState  </td> <td style="text-align: left;">否  </td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">订单支付状态:&lt;br/&gt;0-未支付;&lt;br/&gt;1-支付成功;&lt;br/&gt;2-支付失败;&lt;br/&gt;3-已关闭/已取消;&lt;br/&gt;4-支付中。</td> </tr> <tr> <td style="text-align: left;">refundState</td> <td style="text-align: left;">否</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">订单退款状态:&lt;br/&gt;0-未退款;&lt;br/&gt;1-退款中;&lt;br/&gt;2-退款成功;&lt;br/&gt;3-退款失败。</td> </tr> <tr> <td style="text-align: left;">cursor    </td> <td style="text-align: left;">否  </td> <td style="text-align: left;">String  </td> <td style="text-align: left;">游标,初始为 null,后续请求附带上次翻页的游标                          </td> </tr> <tr> <td style="text-align: left;">size      </td> <td style="text-align: left;">是  </td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">页大小范围:[1,100],可设置一次调用最多返回100条  </td> </tr> </tbody> </table> <h5>返回示例</h5> <pre><code>{     &amp;quot;code&amp;quot;: 0,     &amp;quot;data&amp;quot;: {         &amp;quot;cursor&amp;quot;: &amp;quot;16928242851135488&amp;quot;,         &amp;quot;isLast&amp;quot;: false,         &amp;quot;list&amp;quot;: [             {                 &amp;quot;adId&amp;quot;: &amp;quot;&amp;quot;,                 &amp;quot;adverId&amp;quot;: &amp;quot;&amp;quot;,                 &amp;quot;appAdChannelType&amp;quot;: 0,                 &amp;quot;appId&amp;quot;: 1000,                 &amp;quot;appType&amp;quot;: 2,                 &amp;quot;appVersion&amp;quot;: &amp;quot;1.0&amp;quot;,                 &amp;quot;callback&amp;quot;: &amp;quot;&amp;quot;,                 &amp;quot;contentChapterId&amp;quot;: 0, &amp;quot;chapterName&amp;quot;: &amp;quot;第x集&amp;quot;,                 &amp;quot;contentId&amp;quot;: 0, &amp;quot;contentName&amp;quot;: &amp;quot;xxxxxx&amp;quot;,                 &amp;quot;contentType&amp;quot;: 0,                 &amp;quot;createDateTime&amp;quot;: &amp;quot;2023-07-31 17:03:56&amp;quot;,                 &amp;quot;creativeId&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;firstVisitPromotionTime&amp;quot;: &amp;quot;2023-07-26 17:03:00&amp;quot;,                 &amp;quot;id&amp;quot;: 16927522118713344,                 &amp;quot;membeCreateDate&amp;quot;: &amp;quot;2023-07-26 17:52:41&amp;quot;,                 &amp;quot;memberId&amp;quot;: 15127853466124288,                 &amp;quot;memberIp&amp;quot;: &amp;quot;127.0.0.1&amp;quot;,                 &amp;quot;orderAmount&amp;quot;: 1,                 &amp;quot;orderProductResList&amp;quot;: [                     {                         &amp;quot;coinsBonus&amp;quot;: 1,                         &amp;quot;coinsBuy&amp;quot;: 1,                         &amp;quot;daysSubscribe&amp;quot;: 0,                         &amp;quot;id&amp;quot;: 16927522286485504,                         &amp;quot;orderId&amp;quot;: 16927522118713344,                         &amp;quot;originalPrice&amp;quot;: 0,                         &amp;quot;productId&amp;quot;: 8552586793975808,                         &amp;quot;productName&amp;quot;: &amp;quot;昌宇专属哇卡&amp;quot;,                         &amp;quot;productPrice&amp;quot;: 1,                         &amp;quot;productType&amp;quot;: 1                     }                 ],                 &amp;quot;outTradeNo&amp;quot;: &amp;quot;&amp;quot;,                 &amp;quot;partnerManagerId&amp;quot;: 11134977371013120,                 &amp;quot;partnerPrimaryId&amp;quot;: 1000001,                 &amp;quot;partnerSubId&amp;quot;: 10703379290656768,                 &amp;quot;payAppId&amp;quot;: &amp;quot;&amp;quot;,                 &amp;quot;payDate&amp;quot;: null,                 &amp;quot;payState&amp;quot;: 0,                 &amp;quot;payType&amp;quot;: 1,                 &amp;quot;promotionId&amp;quot;: 0, &amp;quot;promotionName&amp;quot;: &amp;quot;xxx&amp;quot;,                 &amp;quot;promotionKeywords&amp;quot;: &amp;quot;xxx&amp;quot;, &amp;quot;refundAmount&amp;quot;: 0, &amp;quot;refundDate&amp;quot;: null, &amp;quot;refundState&amp;quot;: 0,                 &amp;quot;userAgent&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;memberRechargeNumber&amp;quot;:0, &amp;quot;memberRechargeAmount&amp;quot;:0, &amp;quot;memberMobileBrand&amp;quot;:&amp;quot;vivo&amp;quot;             },             {                 &amp;quot;adId&amp;quot;: &amp;quot;&amp;quot;,                 &amp;quot;adverId&amp;quot;: &amp;quot;&amp;quot;,                 &amp;quot;appAdChannelType&amp;quot;: 0,                 &amp;quot;appId&amp;quot;: 1000,                 &amp;quot;appType&amp;quot;: 2,                 &amp;quot;appVersion&amp;quot;: &amp;quot;1.0&amp;quot;,                 &amp;quot;callback&amp;quot;: &amp;quot;&amp;quot;,                 &amp;quot;contentChapterId&amp;quot;: 0, &amp;quot;chapterName&amp;quot;: &amp;quot;第x集&amp;quot;,                 &amp;quot;contentId&amp;quot;: 0, &amp;quot;contentName&amp;quot;: &amp;quot;xxxxxx&amp;quot;,                 &amp;quot;contentType&amp;quot;: 0,                 &amp;quot;createDateTime&amp;quot;: &amp;quot;2023-07-31 17:06:48&amp;quot;,                 &amp;quot;creativeId&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;firstVisitPromotionTime&amp;quot;: &amp;quot;2023-07-26 17:03:35&amp;quot;,                 &amp;quot;id&amp;quot;: 16928242851135488,                 &amp;quot;membeCreateDate&amp;quot;: &amp;quot;2023-07-26 17:52:41&amp;quot;,                 &amp;quot;memberId&amp;quot;: 15127853466124288,                 &amp;quot;memberIp&amp;quot;: &amp;quot;127.0.0.1&amp;quot;,                 &amp;quot;orderAmount&amp;quot;: 1,                 &amp;quot;orderProductResList&amp;quot;: [                     {                         &amp;quot;coinsBonus&amp;quot;: 1,                         &amp;quot;coinsBuy&amp;quot;: 1,                         &amp;quot;daysSubscribe&amp;quot;: 0,                         &amp;quot;id&amp;quot;: 16928243065044992,                         &amp;quot;orderId&amp;quot;: 16928242851135488,                         &amp;quot;originalPrice&amp;quot;: 0,                         &amp;quot;productId&amp;quot;: 8552586793975808,                         &amp;quot;productName&amp;quot;: &amp;quot;昌宇专属哇卡&amp;quot;,                         &amp;quot;productPrice&amp;quot;: 1,                         &amp;quot;productType&amp;quot;: 1                     }                 ],                 &amp;quot;outTradeNo&amp;quot;: &amp;quot;&amp;quot;,                 &amp;quot;partnerManagerId&amp;quot;: 11134977371013120,                 &amp;quot;partnerPrimaryId&amp;quot;: 1000001,                 &amp;quot;partnerSubId&amp;quot;: 10703379290656768,                 &amp;quot;payAppId&amp;quot;: &amp;quot;&amp;quot;,                 &amp;quot;payDate&amp;quot;: null,                 &amp;quot;payState&amp;quot;: 0,                 &amp;quot;payType&amp;quot;: 1,                 &amp;quot;promotionId&amp;quot;: 0, &amp;quot;promotionName&amp;quot;: &amp;quot;xxx&amp;quot;,                 &amp;quot;promotionKeywords&amp;quot;: &amp;quot;xxx&amp;quot;, &amp;quot;refundAmount&amp;quot;: 0, &amp;quot;refundDate&amp;quot;: null, &amp;quot;refundState&amp;quot;: 0,                 &amp;quot;userAgent&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;memberRechargeNumber&amp;quot;:0, &amp;quot;memberRechargeAmount&amp;quot;:0, &amp;quot;memberMobileBrand&amp;quot;:&amp;quot;vivo&amp;quot;             }         ]     },     &amp;quot;msg&amp;quot;: &amp;quot;OK&amp;quot;,     &amp;quot;traceId&amp;quot;: &amp;quot;5313d142-288f-41c3-a6bc-c001a5afa8c2&amp;quot; }</code></pre> <h5>返回参数说明</h5> <table> <thead> <tr> <th style="text-align: left;">参数名    </th> <th style="text-align: left;">类型      </th> <th>说明                        </th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">code      </td> <td style="text-align: left;">Integer    </td> <td>返回码                      </td> </tr> <tr> <td style="text-align: left;">msg        </td> <td style="text-align: left;">String    </td> <td>返回消息                    </td> </tr> <tr> <td style="text-align: left;">traceId    </td> <td style="text-align: left;">String    </td> <td>链路追踪 ID                </td> </tr> <tr> <td style="text-align: left;">data      </td> <td style="text-align: left;">Object    </td> <td>游标分页返回数据列表响应    </td> </tr> </tbody> </table> <h6>游标分页返回数据列表响应结构</h6> <table> <thead> <tr> <th style="text-align: left;">参数名  </th> <th style="text-align: left;">类型      </th> <th>说明                      </th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">cursor  </td> <td style="text-align: left;">String    </td> <td>游标(下次翻页带上该参数)</td> </tr> <tr> <td style="text-align: left;">isLast  </td> <td style="text-align: left;">Boolean  </td> <td>是否最后一页              </td> </tr> <tr> <td style="text-align: left;">list    </td> <td style="text-align: left;">List      </td> <td>数据列表                  </td> </tr> </tbody> </table> <h6>数据列表项响应结构</h6> <table> <thead> <tr> <th style="text-align: left;">参数名              </th> <th style="text-align: left;">类型    </th> <th>说明                                                                    </th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">id                  </td> <td style="text-align: left;">Long    </td> <td>订单 ID                                                                      </td> </tr> <tr> <td style="text-align: left;">partnerPrimaryId    </td> <td style="text-align: left;">Long    </td> <td>所属一级分销商 ID                                                      </td> </tr> <tr> <td style="text-align: left;">partnerManagerId    </td> <td style="text-align: left;">Long    </td> <td>所属主管分销商 ID                                                      </td> </tr> <tr> <td style="text-align: left;">partnerSubId        </td> <td style="text-align: left;">Long    </td> <td>所属子分销商 ID                                                        </td> </tr> <tr> <td style="text-align: left;">appId                </td> <td style="text-align: left;">Long    </td> <td>应用 ID                                                                </td> </tr> <tr> <td style="text-align: left;">appType              </td> <td style="text-align: left;">Integer  </td> <td>应用类型                                                                </td> </tr> <tr> <td style="text-align: left;">promotionId          </td> <td style="text-align: left;">Long    </td> <td>推广链接 ID                                                            </td> </tr> <tr> <td style="text-align: left;">promotionName</td> <td style="text-align: left;">String</td> <td>推广链接名称</td> </tr> <tr> <td style="text-align: left;">promotionKeywords</td> <td style="text-align: left;">String</td> <td>推广链接口令</td> </tr> <tr> <td style="text-align: left;">appVersion          </td> <td style="text-align: left;">String  </td> <td>App 版本号                                                              </td> </tr> <tr> <td style="text-align: left;">appAdChannelType    </td> <td style="text-align: left;">Integer  </td> <td>广告媒体渠道类型:&lt;/br&gt;1-巨量;&lt;/br&gt;2-腾讯MP;&lt;/br&gt;3-腾讯ADQ;&lt;/br&gt;4-快手;&lt;/br&gt;5-百度;&lt;/br&gt;6-其它;&lt;/br&gt;7-UC;&lt;/br&gt;8-VIVO;&lt;/br&gt;9-OPPO;&lt;/br&gt;10-HUAWEI;&lt;/br&gt;11-HONOR;&lt;/br&gt;12-小米</td> </tr> <tr> <td style="text-align: left;">memberId            </td> <td style="text-align: left;">Long    </td> <td>下单用户 ID                                                            </td> </tr> <tr> <td style="text-align: left;">membeCreateDate      </td> <td style="text-align: left;">DateTime</td> <td>下单人的创建时间                                                        </td> </tr> <tr> <td style="text-align: left;">orderAmount          </td> <td style="text-align: left;">Integer  </td> <td>订单金额                                                                </td> </tr> <tr> <td style="text-align: left;">payState            </td> <td style="text-align: left;">Integer  </td> <td>订单的支付状态                                                          </td> </tr> <tr> <td style="text-align: left;">payAppId            </td> <td style="text-align: left;">String  </td> <td>支付的应用 ID                                                          </td> </tr> <tr> <td style="text-align: left;">payMemberOpenid</td> <td style="text-align: left;">String</td> <td>实际支付的用户 openId</td> </tr> <tr> <td style="text-align: left;">payDate              </td> <td style="text-align: left;">DateTime</td> <td>支付时间                                                                </td> </tr> <tr> <td style="text-align: left;">payType              </td> <td style="text-align: left;">Integer  </td> <td>支付类型,由下单的时候决定                                              </td> </tr> <tr> <td style="text-align: left;">contentId            </td> <td style="text-align: left;">Long    </td> <td>内容 ID                                                                </td> </tr> <tr> <td style="text-align: left;">contentName</td> <td style="text-align: left;">String</td> <td>内容名称</td> </tr> <tr> <td style="text-align: left;">contentType          </td> <td style="text-align: left;">Integer  </td> <td>内容类型                                                                </td> </tr> <tr> <td style="text-align: left;">contentChapterId    </td> <td style="text-align: left;">Long    </td> <td>内容的章节 ID                                                          </td> </tr> <tr> <td style="text-align: left;">chapterName</td> <td style="text-align: left;">String</td> <td>内容的章节名称</td> </tr> <tr> <td style="text-align: left;">activityId</td> <td style="text-align: left;">Long</td> <td>活动 ID</td> </tr> <tr> <td style="text-align: left;">memberIp            </td> <td style="text-align: left;">String  </td> <td>下单用户 IP                                                            </td> </tr> <tr> <td style="text-align: left;">adverId              </td> <td style="text-align: left;">String  </td> <td>投放的广告主 ID                                                        </td> </tr> <tr> <td style="text-align: left;">adId                </td> <td style="text-align: left;">String  </td> <td>投放的广告计划 ID                                                      </td> </tr> <tr> <td style="text-align: left;">callback            </td> <td style="text-align: left;">String  </td> <td>上报信息                                                                </td> </tr> <tr> <td style="text-align: left;">creativeId          </td> <td style="text-align: left;">String  </td> <td>创意 ID                                                                </td> </tr> <tr> <td style="text-align: left;">outTradeNo          </td> <td style="text-align: left;">Stirng  </td> <td>第三方的订单号                                                          </td> </tr> <tr> <td style="text-align: left;">createDateTime      </td> <td style="text-align: left;">DateTime</td> <td>订单创建时间                                                            </td> </tr> <tr> <td style="text-align: left;">userAgent            </td> <td style="text-align: left;">String  </td> <td>下单用户的用户代理                                                      </td> </tr> <tr> <td style="text-align: left;">firstVisitPromotionTime</td> <td style="text-align: left;">DateTime</td> <td>下单用户首次访问推广链接的时间</td> </tr> <tr> <td style="text-align: left;">refundState</td> <td style="text-align: left;">Integer</td> <td>订单退款状态:&lt;br/&gt;0-未退款;&lt;br/&gt;1-退款中;&lt;br/&gt;2-退款成功;&lt;br/&gt;3-退款失败。</td> </tr> <tr> <td style="text-align: left;">refundAmount</td> <td style="text-align: left;">Integer</td> <td>退款金额</td> </tr> <tr> <td style="text-align: left;">refundDate</td> <td style="text-align: left;">DateTime</td> <td>退款时间</td> </tr> <tr> <td style="text-align: left;">memberRechargeNumber</td> <td style="text-align: left;">Integer</td> <td>用户到此订单为止的充值次数</td> </tr> <tr> <td style="text-align: left;">memberRechargeAmount</td> <td style="text-align: left;">Integer</td> <td>用户到此订单为止的充值金额</td> </tr> <tr> <td style="text-align: left;">memberMobileBrand</td> <td style="text-align: left;">String</td> <td>用户手机型号(可能为空)</td> </tr> <tr> <td style="text-align: left;">orderProductResList  </td> <td style="text-align: left;">List    </td> <td>订单商品信息列表                                                        </td> </tr> </tbody> </table> <h6>订单商品信息列表项响应结构</h6> <table> <thead> <tr> <th style="text-align: left;">参数名              </th> <th style="text-align: left;">类型    </th> <th>说明                </th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">id                  </td> <td style="text-align: left;">Long    </td> <td>订单商品信息 ID                  </td> </tr> <tr> <td style="text-align: left;">orderId              </td> <td style="text-align: left;">Long    </td> <td>订单 ID              </td> </tr> <tr> <td style="text-align: left;">productId            </td> <td style="text-align: left;">Long    </td> <td>商品 ID              </td> </tr> <tr> <td style="text-align: left;">productName          </td> <td style="text-align: left;">String  </td> <td>商品名称            </td> </tr> <tr> <td style="text-align: left;">productPrice        </td> <td style="text-align: left;">Integer  </td> <td>商品价格,单位:分  </td> </tr> <tr> <td style="text-align: left;">originalPrice        </td> <td style="text-align: left;">Integer  </td> <td>商品原价,单位:分  </td> </tr> <tr> <td style="text-align: left;">productType          </td> <td style="text-align: left;">Integer  </td> <td>商品类型            </td> </tr> <tr> <td style="text-align: left;">coinsBuy            </td> <td style="text-align: left;">Integer  </td> <td>购买的金币数量      </td> </tr> <tr> <td style="text-align: left;">coinsBonus          </td> <td style="text-align: left;">Integer  </td> <td>赠送金币数          </td> </tr> <tr> <td style="text-align: left;">daysSubscribe        </td> <td style="text-align: left;">Integer  </td> <td>VIP 订阅天数        </td> </tr> </tbody> </table> <h5>备注</h5> <ul> <li>返回错误代码请查看[错误响应](<a href="https://www.showdoc.com.cn/gatewaypartnerv1/10903560257841502">https://www.showdoc.com.cn/gatewaypartnerv1/10903560257841502</a> &quot;错误响应&quot;)页面描述</li> </ul>

页面列表

ITEM_HTML