最佳商品日历接口
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>最佳商品接口</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>https://api.459n.com/api/v3/generateDrops</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST </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>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">authorization</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>传参时候数据前缀带上 “Bearer 'token'”</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code>{
&quot;results&quot;: [
{
&quot;year&quot;: 2024,
&quot;month&quot;: &quot;December&quot;,
&quot;drops&quot;: [
{
&quot;drop_id&quot;: &quot;RA165-001&quot;,
&quot;drop_date&quot;: &quot;2024-12-02T00:00:00+00:00&quot;,
&quot;drop_plan&quot;: 20,
&quot;year&quot;: 2024,
&quot;week&quot;: 1,
&quot;day&quot;: &quot;02&quot;,
&quot;month&quot;: &quot;December&quot;,
&quot;short_month&quot;: &quot;Dec&quot;,
&quot;translated_month&quot;: &quot;December&quot;,
&quot;coming&quot;: 0,
&quot;current_latest&quot;: 0,
&quot;latest&quot;: false,
&quot;comming_up&quot;: false,
&quot;week_start_date&quot;: &quot;2024-12-02&quot;,
&quot;week_end_date&quot;: &quot;2024-12-09&quot;
},
{
&quot;drop_id&quot;: &quot;RA165-002&quot;,
&quot;drop_date&quot;: &quot;2024-12-09T00:00:00+00:00&quot;,
&quot;drop_plan&quot;: 20,
&quot;year&quot;: 2024,
&quot;week&quot;: 2,
&quot;day&quot;: &quot;09&quot;,
&quot;month&quot;: &quot;December&quot;,
&quot;short_month&quot;: &quot;Dec&quot;,
&quot;translated_month&quot;: &quot;December&quot;,
&quot;coming&quot;: 0,
&quot;current_latest&quot;: 0,
&quot;latest&quot;: false,
&quot;comming_up&quot;: false,
&quot;week_start_date&quot;: &quot;2024-12-09&quot;,
&quot;week_end_date&quot;: &quot;2024-12-16&quot;
},
{
&quot;drop_id&quot;: &quot;RA165-003&quot;,
&quot;drop_date&quot;: &quot;2024-12-16T00:00:00+00:00&quot;,
&quot;drop_plan&quot;: 20,
&quot;year&quot;: 2024,
&quot;week&quot;: 3,
&quot;day&quot;: &quot;16&quot;,
&quot;month&quot;: &quot;December&quot;,
&quot;short_month&quot;: &quot;Dec&quot;,
&quot;translated_month&quot;: &quot;December&quot;,
&quot;coming&quot;: 0,
&quot;current_latest&quot;: 0,
&quot;latest&quot;: false,
&quot;comming_up&quot;: false,
&quot;week_start_date&quot;: &quot;2024-12-16&quot;,
&quot;week_end_date&quot;: &quot;2024-12-23&quot;
},
{
&quot;drop_id&quot;: &quot;RA165-004&quot;,
&quot;drop_date&quot;: &quot;2024-12-23T00:00:00+00:00&quot;,
&quot;drop_plan&quot;: 20,
&quot;year&quot;: 2024,
&quot;week&quot;: 4,
&quot;day&quot;: &quot;23&quot;,
&quot;month&quot;: &quot;December&quot;,
&quot;short_month&quot;: &quot;Dec&quot;,
&quot;translated_month&quot;: &quot;December&quot;,
&quot;coming&quot;: 0,
&quot;current_latest&quot;: 0,
&quot;latest&quot;: false,
&quot;comming_up&quot;: false,
&quot;week_start_date&quot;: &quot;2024-12-23&quot;,
&quot;week_end_date&quot;: &quot;2024-12-30&quot;
},
{
&quot;drop_id&quot;: &quot;RA165-005&quot;,
&quot;drop_date&quot;: &quot;2024-12-30T00:00:00+00:00&quot;,
&quot;drop_plan&quot;: 20,
&quot;year&quot;: 2024,
&quot;week&quot;: 5,
&quot;day&quot;: &quot;30&quot;,
&quot;month&quot;: &quot;December&quot;,
&quot;short_month&quot;: &quot;Dec&quot;,
&quot;translated_month&quot;: &quot;December&quot;,
&quot;coming&quot;: 0,
&quot;current_latest&quot;: 0,
&quot;latest&quot;: false,
&quot;comming_up&quot;: false,
&quot;week_start_date&quot;: &quot;2024-12-30&quot;,
&quot;week_end_date&quot;: &quot;2025-01-06&quot;
}
]
},
{
&quot;year&quot;: 2025,
&quot;month&quot;: &quot;January&quot;,
&quot;drops&quot;: [
{
&quot;drop_id&quot;: &quot;RA165-006&quot;,
&quot;drop_date&quot;: &quot;2025-01-06T00:00:00+00:00&quot;,
&quot;drop_plan&quot;: 20,
&quot;year&quot;: 2025,
&quot;week&quot;: 1,
&quot;day&quot;: &quot;06&quot;,
&quot;month&quot;: &quot;January&quot;,
&quot;short_month&quot;: &quot;Jan&quot;,
&quot;translated_month&quot;: &quot;January&quot;,
&quot;coming&quot;: 0,
&quot;current_latest&quot;: 1,
&quot;latest&quot;: false,
&quot;comming_up&quot;: false,
&quot;week_start_date&quot;: &quot;2025-01-06&quot;,
&quot;week_end_date&quot;: &quot;2025-01-13&quot;
}
]
}
],
&quot;current_month&quot;: [
{
&quot;drop_id&quot;: &quot;RA165-006&quot;,
&quot;drop_date&quot;: &quot;2025-01-06T00:00:00+00:00&quot;,
&quot;drop_plan&quot;: 20,
&quot;year&quot;: 2025,
&quot;week&quot;: 1,
&quot;day&quot;: &quot;06&quot;,
&quot;month&quot;: &quot;January&quot;,
&quot;short_month&quot;: &quot;Jan&quot;,
&quot;translated_month&quot;: &quot;January&quot;,
&quot;coming&quot;: 0,
&quot;current_latest&quot;: 1,
&quot;latest&quot;: false,
&quot;comming_up&quot;: false,
&quot;week_start_date&quot;: &quot;2025-01-06&quot;,
&quot;week_end_date&quot;: &quot;2025-01-13&quot;
}
],
&quot;next_week_available_on&quot;: &quot;Available on January 13, 2025&quot;,
&quot;remaining_time&quot;: {
&quot;days&quot;: 1,
&quot;hours&quot;: 18,
&quot;minutes&quot;: 54,
&quot;seconds&quot;: 59
},
&quot;total_weeks&quot;: 5,
&quot;total_product_count&quot;: 100
}</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;">status</td>
<td style="text-align: left;">int</td>
<td>成功为1，失败为0</td>
</tr>
<tr>
<td style="text-align: left;">code</td>
<td style="text-align: left;">int</td>
<td>成功状态码200</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">string</td>
<td>返回数据</td>
</tr>
<tr>
<td style="text-align: left;">data.results</td>
<td style="text-align: left;">array</td>
<td>结果列表</td>
</tr>
<tr>
<td style="text-align: left;">data.results['year']</td>
<td style="text-align: left;">int</td>
<td>年份</td>
</tr>
<tr>
<td style="text-align: left;">data.results['month']</td>
<td style="text-align: left;">string</td>
<td>月份</td>
</tr>
<tr>
<td style="text-align: left;">data.results['drops']</td>
<td style="text-align: left;">array</td>
<td>每个产品的掉落计划列表</td>
</tr>
<tr>
<td style="text-align: left;">data.results['drops']['drop_id']</td>
<td style="text-align: left;">string</td>
<td>的ID</td>
</tr>
<tr>
<td style="text-align: left;">data.results['drops']['drop_date']</td>
<td style="text-align: left;">string</td>
<td>日期</td>
</tr>
<tr>
<td style="text-align: left;">data.results['drops']['drop_plan']</td>
<td style="text-align: left;">int</td>
<td>数量</td>
</tr>
<tr>
<td style="text-align: left;">data.results['drops']['week']</td>
<td style="text-align: left;">int</td>
<td>第几周</td>
</tr>
<tr>
<td style="text-align: left;">data.results['drops']['day']</td>
<td style="text-align: left;">string</td>
<td>日期（日）</td>
</tr>
<tr>
<td style="text-align: left;">data.results['drops']['month']</td>
<td style="text-align: left;">string</td>
<td>月份</td>
</tr>
<tr>
<td style="text-align: left;">data.results['drops']['short_month']</td>
<td style="text-align: left;">string</td>
<td>月份的缩写</td>
</tr>
<tr>
<td style="text-align: left;">data.results['drops']['translated_month']</td>
<td style="text-align: left;">string</td>
<td>翻译后的月份名</td>
</tr>
<tr>
<td style="text-align: left;">data.results['drops']['coming']</td>
<td style="text-align: left;">int</td>
<td>即将推出标签（1 为是，0 为否）</td>
</tr>
<tr>
<td style="text-align: left;">data.results['drops']['current_latest']</td>
<td style="text-align: left;">int</td>
<td>当前是否为最新（1 为是，0 为否）</td>
</tr>
<tr>
<td style="text-align: left;">data.results['drops']['comming_up']</td>
<td style="text-align: left;">int</td>
<td>是否是未来周未开始的周</td>
</tr>
<tr>
<td style="text-align: left;">data.results['drops']['week_start_date']</td>
<td style="text-align: left;">string</td>
<td>本周开始日期</td>
</tr>
<tr>
<td style="text-align: left;">data.results['drops']['week_end_date']</td>
<td style="text-align: left;">string</td>
<td>本周结束日期</td>
</tr>
<tr>
<td style="text-align: left;">data.current_month</td>
<td style="text-align: left;">array</td>
<td>当前月份的掉落计划列表</td>
</tr>
<tr>
<td style="text-align: left;">data.current_month['drop_id']</td>
<td style="text-align: left;">string</td>
<td>当前月份的掉落ID</td>
</tr>
<tr>
<td style="text-align: left;">data.current_month['drop_date']</td>
<td style="text-align: left;">string</td>
<td>当前月份的掉落日期</td>
</tr>
<tr>
<td style="text-align: left;">data.current_month['drop_plan']</td>
<td style="text-align: left;">int</td>
<td>当前月份的掉落计划数量</td>
</tr>
<tr>
<td style="text-align: left;">data.current_month['week']</td>
<td style="text-align: left;">int</td>
<td>当前月份的周次</td>
</tr>
<tr>
<td style="text-align: left;">data.current_month['day']</td>
<td style="text-align: left;">string</td>
<td>当前月份的日期（日）</td>
</tr>
<tr>
<td style="text-align: left;">data.current_month['month']</td>
<td style="text-align: left;">string</td>
<td>当前月份</td>
</tr>
<tr>
<td style="text-align: left;">data.current_month['short_month']</td>
<td style="text-align: left;">string</td>
<td>当前月份的缩写</td>
</tr>
<tr>
<td style="text-align: left;">data.current_month['translated_month']</td>
<td style="text-align: left;">string</td>
<td>当前月份的翻译</td>
</tr>
<tr>
<td style="text-align: left;">data.current_month['coming']</td>
<td style="text-align: left;">int</td>
<td>是否即将到来（1 为是，0 为否）</td>
</tr>
<tr>
<td style="text-align: left;">data.current_month['current_latest']</td>
<td style="text-align: left;">int</td>
<td>当前是否为最新（1 为是，0 为否）</td>
</tr>
<tr>
<td style="text-align: left;">data.current_month['comming_up']</td>
<td style="text-align: left;">int</td>
<td>是否是未来周未开始的周</td>
</tr>
<tr>
<td style="text-align: left;">data.current_month['week_start_date']</td>
<td style="text-align: left;">string</td>
<td>当前月份本周开始日期</td>
</tr>
<tr>
<td style="text-align: left;">data.current_month['week_end_date']</td>
<td style="text-align: left;">string</td>
<td>当前月份本周结束日期</td>
</tr>
<tr>
<td style="text-align: left;">data.next_week_available_on</td>
<td style="text-align: left;">string</td>
<td>下周可用日期</td>
</tr>
<tr>
<td style="text-align: left;">data.remaining_time</td>
<td style="text-align: left;">object</td>
<td>剩余时间</td>
</tr>
<tr>
<td style="text-align: left;">data.remaining_time['days']</td>
<td style="text-align: left;">int</td>
<td>剩余天数</td>
</tr>
<tr>
<td style="text-align: left;">data.remaining_time['hours']</td>
<td style="text-align: left;">int</td>
<td>剩余小时数</td>
</tr>
<tr>
<td style="text-align: left;">data.remaining_time['minutes']</td>
<td style="text-align: left;">int</td>
<td>剩余分钟数</td>
</tr>
<tr>
<td style="text-align: left;">data.remaining_time['seconds']</td>
<td style="text-align: left;">int</td>
<td>剩余秒数</td>
</tr>
<tr>
<td style="text-align: left;">data.total_weeks</td>
<td style="text-align: left;">int</td>
<td>总周数</td>
</tr>
<tr>
<td style="text-align: left;">data.total_product_count</td>
<td style="text-align: left;">int</td>
<td>总产品数量</td>
</tr>
</tbody>
</table>
<h5>备注</h5>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>