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	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	290	\ No newline at end of file
...	...

OPEN-API / WIKI · Commits

GitLab

a