a (31badc2c) | Commits | OPEN-API / WIKI

Browse Code »

Commit 31badc2ca2a5c280a76b287a7a9fc7f1c7c11ad8

Authored by 国亚奇 2019-07-12 14:57:19 +0800

1 parent 0e537ea4

a

Inline Side-by-side

Showing 1 changed file with 288 additions and 325 deletions

07.增值云/1.3 商品-创建商品.md

View file @31badc2

1	-/*
2	- Title: 1.1 获取商品列表
3	- Sort: 1
4	-*/
5	-#### URL: http://console.open.cnlive.com/open/api/pom/manageProduct
6	------
7	-#### 请求方式: POST
8	------
9	-#### 返回格式: JSON
10	------
11	-#### 请求参数说明:
12	-<table class="table table-bordered table-striped table-condensed">
13	-<tr>
14	- <th>参数</th>
15	- <th>必选</th>
16	- <th>类型</th>
17	- <th>说明</th>
18	-</tr>
19	-<tr>
20	- <td>sp_id</td>
21	- <td>true</td>
22	- <td>String</td>
23	- <td>服务提供商ID</td>
24	-</tr>
25	-<tr>
26	- <td>plat</td>
27	- <td>true</td>
28	- <td>String</td>
29	- <td>平台类型</td>
30	-</tr>
31	- <tr>
32	- <td>prdUUID</td>
33	- <td>false</td>
34	- <td>String</td>
35	- <td>商品ID,不传系统默认生成商品ID</td>
36	- </tr>
37	- <tr>
38	- <td>bigPosterImage</td>
39	- <td>false</td>
40	- <td>File</td>
41	- <td>商品海报大图</td>
42	- </tr>
43	- <tr>
44	- <td>smallPosterImage</td>
45	- <td>false</td>
46	- <td>File</td>
47	- <td>商品海报小图</td>
48	- </tr>
49	- <tr>
50	- <td>effectiveDate </td>
51	- <td>true</td>
52	- <td>String</td>
53	- <td>商品生效时间,格式为yyyy-MM-ff HH:mm:ss</td>
54	- </tr>
55	- <tr>
56	- <td>expiryDate </td>
57	- <td>true</td>
58	- <td>String</td>
59	- <td>商品无效时间,格式为yyyy-MM-ff HH:mm:ss</td>
60	- </tr>
61	- <tr>
62	- <td>pt.title </td>
63	- <td>true</td>
64	- <td>String</td>
65	- <td>商品名</td>
66	- </tr>
67	- <tr>
68	- <td>pt.descript </td>
69	- <td>false</td>
70	- <td>String</td>
71	- <td>商品描述</td>
72	- </tr>
73	- <tr>
74	- <td>pt.homePage </td>
75	- <td>false</td>
76	- <td>String</td>
77	- <td>商品主页</td>
78	- </tr>
79	- <tr>
80	- <td>pt.weight </td>
81	- <td>false</td>
82	- <td>Integer</td>
83	- <td>商品权重</td>
84	- </tr>
85	- <tr>
86	- <td>pt.status </td>
87	- <td>true</td>
88	- <td>Integer</td>
89	- <td>商品状态, 0下线 1上线</td>
90	- </tr>
91	- <tr>
92	- <td>pt.currency </td>
93	- <td>true</td>
94	- <td>Integer</td>
95	- <td>支付币种 1中国币 2人民币 3中国币/人民币</td>
96	- </tr>
97	- <tr>
98	- <td>pt.rmb </td>
99	- <td>false</td>
100	- <td>Integer</td>
101	- <td>人民币价格，单位分;人民币支付时必填</td>
102	- </tr>
103	- <tr>
104	- <td>pt.originalRmb </td>
105	- <td>false</td>
106	- <td>Integer</td>
107	- <td>人民币原价，单位分;人民币支付时必填</td>
108	- </tr>
109	- <tr>
110	- <td>pt.cnCoin </td>
111	- <td>false</td>
112	- <td>Integer</td>
113	- <td>中国币价格;中国币支付时必填</td>
114	- </tr>
115	- <tr>
116	- <td>pt.originalCnCoin </td>
117	- <td>false</td>
118	- <td>Integer</td>
119	- <td>中国币原价;中国币支付时必填</td>
120	- </tr>
121	- <tr>
122	- <td>pt.discount1 </td>
123	- <td>false</td>
124	- <td>Integer</td>
125	- <td>折扣1，批量购买数达到10</td>
126	- </tr>
127	- <tr>
128	- <td>pt.discount2 </td>
129	- <td>false</td>
130	- <td>Integer</td>
131	- <td>折扣2，批量购买数达到20</td>
132	- </tr>
133	- <tr>
134	- <td>pt.stock </td>
135	- <td>true</td>
136	- <td>Integer</td>
137	- <td>库存; -1为无限库存</td>
138	- </tr>
139	- <tr>
140	- <td>pt.originalStock </td>
141	- <td>true</td>
142	- <td>Integer</td>
143	- <td>库存; -1为无限库存</td>
144	- </tr>
145	- <tr>
146	- <td>pt.type </td>
147	- <td>true</td>
148	- <td>Integer</td>
149	- <td>商品分类 0 虚拟物品 1实物 2视频</td>
150	- </tr>
151	- <tr>
152	- <td>pt.subType </td>
153	- <td>true</td>
154	- <td>Integer</td>
155	- <td>商品类型 001充值卡 002电子票 200视频</td>
156	- </tr>
157	- <tr>
158	- <td>pt.validPeriod </td>
159	- <td>true</td>
160	- <td>Integer</td>
161	- <td>商品包月天数</td>
162	- </tr>
163	- <tr>
164	- <td>pt.resourceType </td>
165	- <td>true</td>
166	- <td>Integer</td>
167	- <td>商品包类型</td>
168	- </tr>
169	- <tr>
170	- <td>pt.resource </td>
171	- <td>true</td>
172	- <td>Integer</td>
173	- <td>商品包资源（栏目ID）</td>
174	- </tr>
175	-<tr>
176	- <td>sign</td>
177	- <td>true</td>
178	- <td>String</td>
179	- <td>签名</td>
180	-</tr>
181	-</table>
182	-
183	------
184	-#### 返回格式说明:
185	-```
186	-成功：
187	-{
188	- "prdId": "83a9c421-5b6e-4fe1-a77e-6831e5785e63",
189	- "title": "weng",
190	- "bigPoster": "http://www.cnlive.com",
191	- "smallPoster": "http://www.cnlive.com",
192	- "homePage": "http://www.cnlive.com",
193	- "currency": "3",
194	- "rmb": "5",
195	- "originalRmb": "7",
196	- "cnCoin": "5000",
197	- "originalCnCoin": "7000",
198	- "discount1": "95",
199	- "discount2": "90",
200	- "type": "0",
201	- "subType": "001",
202	- "stock": "-1",
203	- "originalStock": "-1",
204	- "validPeriod": "0",
205	- "resourceType": "",
206	- "resource": "",
207	- "effectiveDate": "2014-11-16 10:42:14",
208	- "expiryDate": "2014-11-16 10:42:14"
209	- }
210	-}
211	-失败：
212	-{
213	- "errorCode":"xxxx",
214	- "errorMessage":"缺少参数\|参数格式错误\|plat参数非法\|"
215	-}
216	-
217	-```
218	------
219	-#### 返回参数说明:
220	-<table class="table table-bordered table-striped table-condensed">
221	- <tr>
222	- <td>参数 </td>
223	- <td>参数说明</td>
224	- </tr>
225	- <tr>
226	- <td>prdId </td>
227	- <td>商品ID</td>
228	- </tr>
229	- <tr>
230	- <td>title </td>
231	- <td>商品名</td>
232	- </tr>
233	- <tr>
234	- <td>bigPoster </td>
235	- <td>商品海报大图</td>
236	- </tr>
237	- <tr>
238	- <td>smallPoster </td>
239	- <td>商品海报小图</td>
240	- </tr>
241	- <tr>
242	- <td>currency </td>
243	- <td>支付币种 1中国币 2人民币 3中国币/人民币</td>
244	- </tr>
245	- <tr>
246	- <td>rmb </td>
247	- <td>人民币价格，单位分</td>
248	- </tr>
249	- <tr>
250	- <td>originalRmb </td>
251	- <td>人民币原价，单位分</td>
252	- </tr>
253	- <tr>
254	- <td>cnCoin </td>
255	- <td>中国币价格</td>
256	- </tr>
257	- <tr>
258	- <td>originalCnCoin </td>
259	- <td>中国币原价</td>
260	- </tr>
261	- <tr>
262	- <td>discount1 </td>
263	- <td>折扣1，批量购买数达到10</td>
264	- </tr>
265	- <tr>
266	- <td>discount2 </td>
267	- <td>折扣2，批量购买数达到20</td>
268	- </tr>
269	- <tr>
270	- <td>stock </td>
271	- <td>库存</td>
272	- </tr>
273	- <tr>
274	- <td>type </td>
275	- <td>商品分类 0 虚拟物品 1实物 2视频</td>
276	- </tr>
277	- <tr>
278	- <td>subType </td>
279	- <td>商品类型 001充值卡 002电子票 200视频</td>
280	- </tr>
281	- <tr>
282	- <td>validPeriod </td>
283	- <td>商品包月天数</td>
284	- </tr>
285	- <tr>
286	- <td>resourceType </td>
287	- <td>商品包类型</td>
288	- </tr>
289	- <tr>
290	- <td>resource </td>
291	- <td>商品包资源（栏目ID）</td>
292	- </tr>
293	- <tr>
294	- <td>effectiveDate </td>
295	- <td>商品生效时间</td>
296	- </tr>
297	- <tr>
298	- <td>expiryDate </td>
299	- <td>商品无效时间</td>
300	- </tr>
301	- <tr>
302	- <td>homePage </td>
303	- <td>商家主页</td>
304	- </tr>
305	- <tr>
306	- <td>weight </td>
307	- <td>权重</td>
308	- </tr>
309	- <tr>
310	- <td>status </td>
311	- <td>商品状态 0 未上线 1已上线</td>
312	- </tr>
313	- <tr>
314	- <td>previous_cursor </td>
315	- <td>前一页</td>
316	- </tr>
317	- <tr>
318	- <td>next_cursor </td>
319	- <td>后一页</td>
320	- </tr>
321	- <tr>
322	- <td>total_number </td>
323	- <td>总页数</td>
324	- </tr>
325	-</table>
326	\ No newline at end of file	1	\ No newline at end of file
		2	+/*
		3	+ Title: 1.1 获取商品列表
		4	+ Sort: 1
		5	+*/
		6	+#### URL: http://console.open.cnlive.com/open/api/pom/manageProduct
		7	+-----
		8	+#### 请求方式: POST
		9	+-----
		10	+#### 返回格式: JSON
		11	+-----
		12	+#### 请求参数说明:
		13	+<table class="table table-bordered table-striped table-condensed">
		14	+<tr>
		15	+ <th>参数</th>
		16	+ <th>必选</th>
		17	+ <th>类型</th>
		18	+ <th>说明</th>
		19	+</tr>
		20	+<tr>
		21	+ <td>spId</td>
		22	+ <td>true</td>
		23	+ <td>String</td>
		24	+ <td>服务提供商ID</td>
		25	+</tr>
		26	+<tr>
		27	+ <td>plat</td>
		28	+ <td>true</td>
		29	+ <td>String</td>
		30	+ <td>平台类型</td>
		31	+</tr>
		32	+<tr>
		33	+ <td>prdUUID</td>
		34	+ <td>false</td>
		35	+ <td>String</td>
		36	+ <td>商品ID;不传默认系统生成商品ID</td>
		37	+ </tr>
		38	+<tr>
		39	+ <td>pt.title </td>
		40	+ <td>true</td>
		41	+ <td>String</td>
		42	+ <td>商品名</td>
		43	+ </tr>
		44	+ <tr>
		45	+ <td>pt.descript </td>
		46	+ <td>false</td>
		47	+ <td>String</td>
		48	+ <td>商品描述</td>
		49	+ </tr>
		50	+ <tr>
		51	+ <td>bigPosterImage</td>
		52	+ <td>false</td>
		53	+ <td>File</td>
		54	+ <td>商品海报大图</td>
		55	+ </tr>
		56	+ <tr>
		57	+ <td>smallPosterImage</td>
		58	+ <td>false</td>
		59	+ <td>File</td>
		60	+ <td>商品海报小图</td>
		61	+ </tr>
		62	+ <tr>
		63	+ <td>pt.homePage </td>
		64	+ <td>false</td>
		65	+ <td>String</td>
		66	+ <td>商品主页</td>
		67	+ </tr>
		68	+ <tr>
		69	+ <td>effectiveDate </td>
		70	+ <td>true</td>
		71	+ <td>String</td>
		72	+ <td>商品生效时间;格式为yyyy-MM-ff HH:mm:ss</td>
		73	+ </tr>
		74	+ <tr>
		75	+ <td>expiryDate </td>
		76	+ <td>true</td>
		77	+ <td>String</td>
		78	+ <td>商品无效时间;格式为yyyy-MM-ff HH:mm:ss</td>
		79	+ </tr>
		80	+ <tr>
		81	+ <td>pt.spId </td>
		82	+ <td>true</td>
		83	+ <td>String</td>
		84	+ <td>商品的spId</td>
		85	+ </tr>
		86	+ <tr>
		87	+ <td>pt.weight </td>
		88	+ <td>false</td>
		89	+ <td>Integer</td>
		90	+ <td>商品权重(0-100)</td>
		91	+ </tr>
		92	+ <tr>
		93	+ <td>pt.status </td>
		94	+ <td>true</td>
		95	+ <td>Integer</td>
		96	+ <td>商品状态, 0下线 1上线</td>
		97	+ </tr>
		98	+ <tr>
		99	+ <td>pt.type </td>
		100	+ <td>true</td>
		101	+ <td>Integer</td>
		102	+ <td>商品分类 0 虚拟物品 1实物 2视频</td>
		103	+ </tr>
		104	+ <tr>
		105	+ <td>pt.subType </td>
		106	+ <td>true</td>
		107	+ <td>String</td>
		108	+ <td>商品类型 001充值卡 002电子票 200视频</td>
		109	+ </tr>
		110	+
		111	+
		112	+
		113	+ <tr>
		114	+ <td>pt.currency </td>
		115	+ <td>true</td>
		116	+ <td>Integer</td>
		117	+ <td>支付币种 1中国币 2人民币 3中国币/人民币</td>
		118	+ </tr>
		119	+ <tr>
		120	+ <td>pt.vipRmb </td>
		121	+ <td>false</td>
		122	+ <td>Integer</td>
		123	+ <td>vip价格;人民币支付时选填</td>
		124	+ </tr>
		125	+ <tr>
		126	+ <td>pt.rmb </td>
		127	+ <td>false</td>
		128	+ <td>Integer</td>
		129	+ <td>人民币价格，单位分;人民币支付时必填</td>
		130	+ </tr>
		131	+ <tr>
		132	+ <td>pt.originalRmb </td>
		133	+ <td>false</td>
		134	+ <td>Integer</td>
		135	+ <td>人民币原价，单位分;人民币支付时必填</td>
		136	+ </tr>
		137	+ <tr>
		138	+ <td>pt.cnCoin </td>
		139	+ <td>false</td>
		140	+ <td>Integer</td>
		141	+ <td>中国币价格;中国币支付时必填</td>
		142	+ </tr>
		143	+ <tr>
		144	+ <td>pt.originalCnCoin </td>
		145	+ <td>false</td>
		146	+ <td>Integer</td>
		147	+ <td>中国币原价;中国币支付时必填</td>
		148	+ </tr>
		149	+
		150	+ <tr>
		151	+ <td>pt.monthPrice1 </td>
		152	+ <td>false</td>
		153	+ <td>Integer</td>
		154	+ <td>人民币包月价，单位分;产品包人民币支付时必填</td>
		155	+ </tr>
		156	+ <tr>
		157	+ <td>pt.monthPrice2 </td>
		158	+ <td>false</td>
		159	+ <td>Integer</td>
		160	+ <td>人民币包半年价，单位分;产品包人民币支付时必填</td>
		161	+ </tr>
		162	+ <tr>
		163	+ <td>pt.monthPrice3 </td>
		164	+ <td>false</td>
		165	+ <td>Integer</td>
		166	+ <td>人民币包年价，单位分;产品包人民币支付时必填</td>
		167	+ </tr>
		168	+ <tr>
		169	+ <td>pt.discount1 </td>
		170	+ <td>false</td>
		171	+ <td>Integer</td>
		172	+ <td>折扣1，批量购买数达到10</td>
		173	+ </tr>
		174	+ <tr>
		175	+ <td>pt.discount2 </td>
		176	+ <td>false</td>
		177	+ <td>Integer</td>
		178	+ <td>折扣2，批量购买数达到20</td>
		179	+ </tr>
		180	+
		181	+
		182	+
		183	+ <tr>
		184	+ <td>pt.stock </td>
		185	+ <td>true</td>
		186	+ <td>Integer</td>
		187	+ <td>库存; -1为无限库存</td>
		188	+ </tr>
		189	+ <tr>
		190	+ <td>pt.originalStock </td>
		191	+ <td>true</td>
		192	+ <td>Integer</td>
		193	+ <td>库存; -1为无限库存</td>
		194	+ </tr>
		195	+
		196	+
		197	+ <tr>
		198	+ <td>pt.maxNumOfOrders </td>
		199	+ <td>true</td>
		200	+ <td>Integer</td>
		201	+ <td>最大订购数</td>
		202	+ </tr>
		203	+ <tr>
		204	+ <td>pt.orderingGuide </td>
		205	+ <td>false</td>
		206	+ <td>String</td>
		207	+ <td>订购说明</td>
		208	+ </tr>
		209	+ <tr>
		210	+ <td>pt.activityDesc </td>
		211	+ <td>false</td>
		212	+ <td>String</td>
		213	+ <td>活动说明</td>
		214	+ </tr>
		215	+ <tr>
		216	+ <td>pt.maxNumOfUse </td>
		217	+ <td>true</td>
		218	+ <td>Integer</td>
		219	+ <td>最大使用次数;0-多次使用;1-只能使用1次;n-最多使用n次</td>
		220	+ </tr>
		221	+ <tr>
		222	+ <td>pt.validPeriod </td>
		223	+ <td>true</td>
		224	+ <td>Integer</td>
		225	+ <td>最大使用时长;0-不限时长;N-限制观看时长,单位小时</td>
		226	+ </tr>
		227	+
		228	+
		229	+ <tr>
		230	+ <td>pt.resourceType </td>
		231	+ <td>true</td>
		232	+ <td>String</td>
		233	+ <td>商品包类型; 0-单项;1-普通包;1-会员包</td>
		234	+ </tr>
		235	+ <tr>
		236	+ <td>pt.resource </td>
		237	+ <td>false</td>
		238	+ <td>String</td>
		239	+ <td>商品包资源（栏目ID）</td>
		240	+ </tr>
		241	+ <tr>
		242	+ <td>pt.freeCoupon </td>
		243	+ <td>false</td>
		244	+ <td>Integer</td>
		245	+ <td>产品包增送的免费卷张数</td>
		246	+ </tr>
		247	+<tr>
		248	+ <td>sign</td>
		249	+ <td>true</td>
		250	+ <td>String</td>
		251	+ <td>签名</td>
		252	+</tr>
		253	+</table>
		254	+
		255	+-----
		256	+#### 返回格式说明:
		257	+```
		258	+成功：
		259	+{
		260	+ "prdId": "83a9c421-5b6e-4fe1-a77e-6831e5785e63",
		261	+ "title": "weng",
		262	+ "bigPoster": "http://www.cnlive.com",
		263	+ "smallPoster": "http://www.cnlive.com",
		264	+ "homePage": "http://www.cnlive.com",
		265	+ "currency": "3",
		266	+ "rmb": "5",
		267	+ "originalRmb": "7",
		268	+ "cnCoin": "5000",
		269	+ "originalCnCoin": "7000",
		270	+ "discount1": "95",
		271	+ "discount2": "90",
		272	+ "type": "0",
		273	+ "subType": "001",
		274	+ "stock": "-1",
		275	+ "originalStock": "-1",
		276	+ "validPeriod": "0",
		277	+ "resourceType": "",
		278	+ "resource": "",
		279	+ "effectiveDate": "2014-11-16 10:42:14",
		280	+ "expiryDate": "2014-11-16 10:42:14"
		281	+ }
		282	+}
		283	+失败：
		284	+{
		285	+ "errorCode":"xxxx",
		286	+ "errorMessage":"缺少参数\|参数格式错误\|plat参数非法\|"
		287	+}
		288	+
		289	+```
327	\ No newline at end of file	290	\ No newline at end of file

OPEN-API / WIKI · Commits

GitLab

a