| | 336 | |
| | 337 | === 5.1. “主页-广告、抢试用、榜单”接口 === |
| | 338 | 备注:修改接口,获取“主页-广告、试用、榜单”(原index_enter接口修改,增加“抢试用”列表,修改“榜单列表”增加“标题”、“简介”字段) \\ |
| | 339 | 请求URL:http://cosme.pclady.com.cn/interface/app/v2/index_enter.jsp \\ |
| | 340 | HTTP请求方式:GET \\ |
| | 341 | 是否需要登录:否 \\ |
| | 342 | 返回格式:json \\ |
| | 343 | 缓存方式:* \\ |
| | 344 | 缓存时间:* \\ |
| | 345 | 请求参数:无 \\ |
| | 346 | 请求后端URL:* \\ |
| | 347 | 请求后端参数:* \\ |
| | 348 | 返回 \\ |
| | 349 | {{{ |
| | 350 | { |
| | 351 | "focus": [ //数组,轮播广告 |
| | 352 | { //字典,焦点图项 |
| | 353 | "img": "", //URL,图片 |
| | 354 | "type": 1, //int,类型。1:文章, 2:产品, 3:评测, 4:榜单, 5:外链 |
| | 355 | "article": { //字典,当type为1时,文章终端页面相关属性 |
| | 356 | "id": "" //string,文章ID,用于拼装文章页面URL |
| | 357 | } |
| | 358 | }, |
| | 359 | { |
| | 360 | "img": "", |
| | 361 | "type": 2, |
| | 362 | "product": { //字典,当type为2时,产品终端相关属性 |
| | 363 | "id": "" //string,产品ID,用于拼装产品详情页面URL |
| | 364 | } |
| | 365 | } |
| | 366 | { |
| | 367 | "img": "", |
| | 368 | "type": 3, |
| | 369 | "test": { //字典,当type为3时,产品评测终端相关属性 |
| | 370 | "id": "", //string,产品ID,用于拼装专业评测页面URL |
| | 371 | "name": "" |
| | 372 | } |
| | 373 | }, |
| | 374 | { |
| | 375 | "img": "", |
| | 376 | "type": 4, |
| | 377 | "ranking": { //字典,当type为4时,榜单相关属性 |
| | 378 | "key": "" //string,榜单名字,索引提交的 |
| | 379 | } |
| | 380 | }, |
| | 381 | { |
| | 382 | "img": "", |
| | 383 | "type": 5, |
| | 384 | "web": { //字典,当type为5时,外链相关属性 |
| | 385 | "url": "" //url,外链地址 |
| | 386 | } |
| | 387 | } |
| | 388 | ], |
| | 389 | "trials": [ //数组,试用品数据,固定三个 |
| | 390 | { |
| | 391 | "time": "", //string,试用结束时间 |
| | 392 | "title": "", //大标题 |
| | 393 | "subtitle": "", //小标题 |
| | 394 | "img": "", //图片 |
| | 395 | "count": "", //试用品份数 |
| | 396 | "id": "", //试用品ID |
| | 397 | } |
| | 398 | ], |
| | 399 | "rankings": [ //数组,榜单列表 |
| | 400 | { //字典,榜单项 |
| | 401 | "img": "", //URL,图片URL |
| | 402 | "key": "", //string,榜单名字,索引提交的 |
| | 403 | "title": "", //string,标题 |
| | 404 | "subtitle": "", //string,子标题 |
| | 405 | } |
| | 406 | ], |
| | 407 | "msg": "", |
| | 408 | "ret": 0 |
| | 409 | } |
| | 410 | }}} |
| | 411 | |
| | 412 | === 5.2. “条码匹配产品”接口 === |
| | 413 | 备注:新增接口,使用扫描到的条码匹配返回对应产品信息。 \\ |
| | 414 | 请求URL:http://cosme.pclady.com.cn/interface/app/v2/barcode.jsp?id=110110110 \\ |
| | 415 | HTTP请求方式:GET \\ |
| | 416 | 是否需要登录:否 \\ |
| | 417 | 返回格式:json \\ |
| | 418 | 缓存方式:* \\ |
| | 419 | 缓存时间:* \\ |
| | 420 | 请求参数: \\ |
| | 421 | {{{ |
| | 422 | id //条码编号 |
| | 423 | }}} |
| | 424 | |
| | 425 | 请求后端URL:* \\ |
| | 426 | 请求后端参数:* \\ |
| | 427 | 返回 |
| | 428 | {{{ |
| | 429 | { |
| | 430 | "product": { //字典,产品数据 |
| | 431 | "brand": "", //品牌 |
| | 432 | "c_count": 88, //int, 评论数 |
| | 433 | "id": "", //string, 产品ID, 用于拼装产品详情页面URL |
| | 434 | "img_l": "", //url, 大图 |
| | 435 | "img_s": "", //url, 小图 |
| | 436 | "name": "", //string, 产品名称 |
| | 437 | "price": 1350, //float, 价格 |
| | 438 | "score": 9.3, //float, 评分 |
| | 439 | "model": "", //string, 规格 |
| | 440 | "source": "", //string, 条码数据来源 |
| | 441 | "url": "", //url, 产品详情页面 |
| | 442 | "type": "" //string, 类别 |
| | 443 | }, |
| | 444 | "msg": "", |
| | 445 | "ret": 0 |
| | 446 | } |
| | 447 | }}} |
| | 448 | === 5.3. “推荐产品入库”接口 === |
| | 449 | 备注:新增接口,当扫码结果匹配不到化妆品库内的数据时,可录入推荐产品入库。\\ |
| | 450 | 请求URL:http://cosme.pclady.com.cn/interface/app/v2/recommend_product.jsp \\ |
| | 451 | HTTP请求方式:POST \\ |
| | 452 | 是否需要登录:否 \\ |
| | 453 | 返回格式:json \\ |
| | 454 | 缓存方式:* \\ |
| | 455 | 缓存时间:* \\ |
| | 456 | 请求参数: \\ |
| | 457 | {{{ |
| | 458 | name //产品名称, |
| | 459 | model //产品规格, |
| | 460 | barcode //产品条码 |
| | 461 | }}} |
| | 462 | |
| | 463 | 请求后端URL:* \\ |
| | 464 | 请求后端参数:* \\ |
| | 465 | 返回 \\ |
| | 466 | {{{ |
| | 467 | { |
| | 468 | "msg": "提交成功!", |
| | 469 | "ret": 0 |
| | 470 | } |
| | 471 | }}} |
| | 472 | |
| | 473 | === 5.4. “找美妆-按分类”接口 === |
| | 474 | 备注:修改接口,找美妆-按分类。(原search_category接口修改,增加每个分类对应的图片)\\ |
| | 475 | 请求URL:http://cosme.pclady.com.cn/interface/app/v2/search_category.jsp \\ |
| | 476 | HTTP请求方式:GET \\ |
| | 477 | 是否需要登录:否 \\ |
| | 478 | 返回格式:json \\ |
| | 479 | 缓存方式:* \\ |
| | 480 | 缓存时间:* \\ |
| | 481 | 请求参数:无 \\ |
| | 482 | 请求后端URL:* \\ |
| | 483 | 请求后端参数:* \\ |
| | 484 | 返回 \\ |
| | 485 | {{{ |
| | 486 | { |
| | 487 | "data": [ //数组, 分类列表 |
| | 488 | { |
| | 489 | "hots" : [ //数组, 分类下的热门分类列表 |
| | 490 | [ |
| | 491 | { |
| | 492 | "id": 1, //int, ID |
| | 493 | "name": "", //string, 名称 |
| | 494 | "q": "", //string, 名称 |
| | 495 | "img": "" //url, 图片URL |
| | 496 | } |
| | 497 | ], |
| | 498 | [ |
| | 499 | { |
| | 500 | "id": 1, //int, ID |
| | 501 | "name": "", //string, 名称 |
| | 502 | "q": "", //string, 名称 |
| | 503 | "img": "" //url, 图片URL |
| | 504 | } |
| | 505 | ], |
| | 506 | [ |
| | 507 | { |
| | 508 | "id": 1, //int, ID |
| | 509 | "name": "", //string, 名称 |
| | 510 | "q": "", //string, 名称 |
| | 511 | "img": "" //url, 图片URL |
| | 512 | } |
| | 513 | ] |
| | 514 | ], |
| | 515 | "children": [ //数组, 分类下的子分类 |
| | 516 | { |
| | 517 | "id": 1, //int, ID |
| | 518 | "name": "", //string, 名称 |
| | 519 | "q": "" //string, 名称 |
| | 520 | } |
| | 521 | ], |
| | 522 | "id": 1, //int, 类别ID |
| | 523 | "name": "" //string, 类别名 |
| | 524 | } |
| | 525 | ], |
| | 526 | "msg": "", |
| | 527 | "ret": 0 |
| | 528 | } |
| | 529 | }}} |
| | 530 | |
| | 531 | === 5.5. 终端详情页改为web页面 === |
| | 532 | 备注:新,web开发。“专业评测”、“评论”、“评论的赞”、“更多精彩评论”需要定义响应事件 \\ |
| | 533 | |
| | 534 | === 5.6. “产品终端评论点赞”接口 === |
| | 535 | 备注:新增接口,对产品终端的某条评论点赞 \\ |
| | 536 | 请求URL:http://cosme.pclady.com.cn/interface/app/v2/like.jsp \\ |
| | 537 | HTTP请求方式:POST \\ |
| | 538 | 是否需要登录:否 \\ |
| | 539 | 返回格式:json \\ |
| | 540 | 缓存方式:* \\ |
| | 541 | 缓存时间:* \\ |
| | 542 | 请求参数:\\ |
| | 543 | {{{ |
| | 544 | id //评论编号 |
| | 545 | }}} |
| | 546 | 请求后端URL:* \\ |
| | 547 | 请求后端参数:* \\ |
| | 548 | 返回 \\ |
| | 549 | {{{ |
| | 550 | { |
| | 551 | "msg": "提交成功!", |
| | 552 | "ret": 0 |
| | 553 | } |
| | 554 | }}} |
| | 555 | |
| | 556 | === 5.7. "产品终端评论提交"接口 === |
| | 557 | 备注:新增接口,产品终端评论提交 \\ |
| | 558 | 请求URL:http://cosme.pclady.com.cn/interface/app/v2/comment.jsp \\ |
| | 559 | HTTP请求方式:POST \\ |
| | 560 | 是否需要登录:否 \\ |
| | 561 | 返回格式:json \\ |
| | 562 | 缓存方式:* \\ |
| | 563 | 缓存时间:* \\ |
| | 564 | 请求参数: \\ |
| | 565 | {{{ |
| | 566 | id //评论产品的ID |
| | 567 | score //赞: 0、中立: 1、踩: 2 |
| | 568 | title //标题 |
| | 569 | desc //描述 |
| | 570 | images //图片 |
| | 571 | }}} |
| | 572 | |
| | 573 | 请求后端URL:* \\ |
| | 574 | 请求后端参数:* \\ |
| | 575 | 返回 \\ |
| | 576 | |
| | 577 | {{{ |
| | 578 | { |
| | 579 | "msg": "提交成功!", |
| | 580 | "ret": 0 |
| | 581 | } |
| | 582 | }}} |
| | 583 | |
| | 584 | === 5.8. “评论列表”接口 === |
| | 585 | 备注:修改接口,修改原comment_list接口,增加每一条评论对应的“赞”的数量字段,修改接口支持按“全部、试用、赞、中立、踩”获取数据 \\ |
| | 586 | 请求URL:http://cosme.pclady.com.cn/interface/app/v2/comment_list.jsp \\ |
| | 587 | HTTP请求方式:GET \\ |
| | 588 | 是否需要登录:否 \\ |
| | 589 | 返回格式:json \\ |
| | 590 | 缓存方式:* \\ |
| | 591 | 缓存时间:* \\ |
| | 592 | 请求参数: \\ |
| | 593 | {{{ |
| | 594 | id //评论产品的ID |
| | 595 | tag //分类 0、1、2、3、4 |
| | 596 | page //页数 |
| | 597 | size //每页条数 |
| | 598 | }}} |
| | 599 | |
| | 600 | 请求后端URL:* \\ |
| | 601 | 请求后端参数:* \\ |
| | 602 | 返回 \\ |
| | 603 | {{{ |
| | 604 | { |
| | 605 | "list": [ |
| | 606 | { |
| | 607 | "age": "", //string, 年龄 |
| | 608 | "audit": 3, //int, 1:好, 2:一般, 3:不好 |
| | 609 | "content": "", //string, 评论内容 |
| | 610 | "digest": true, //bool, true:显示精华图标, 否则不显示 |
| | 611 | "id": "", //string, 评论id |
| | 612 | "logo": "", //url, 用户头像 |
| | 613 | "name": "", //string, 昵称 |
| | 614 | "skin": "", //string, 肤质 |
| | 615 | "status": 2, |
| | 616 | "time": "", //date, 评论时间 |
| | 617 | "try": false, //bool, true:显示试用图标, 否则不显示 |
| | 618 | "vip": true, //bool, true:显示达人图标, 否则不显示 |
| | 619 | "like": 999 //int, 赞的数量 |
| | 620 | }, |
| | 621 | "tags": [ |
| | 622 | { |
| | 623 | "title": "全部", |
| | 624 | "tag": "0", |
| | 625 | "count": 999 |
| | 626 | }, |
| | 627 | { |
| | 628 | "title": "试用", |
| | 629 | "tag": "1", |
| | 630 | "count": 999 |
| | 631 | }, |
| | 632 | { |
| | 633 | "title": "赞", |
| | 634 | "tag": "2", |
| | 635 | "count": 999 |
| | 636 | }, |
| | 637 | { |
| | 638 | "title": "中立", |
| | 639 | "tag": "3", |
| | 640 | "count": 999 |
| | 641 | }, |
| | 642 | { |
| | 643 | "title": "踩", |
| | 644 | "tag": "4", |
| | 645 | "count": 999 |
| | 646 | } |
| | 647 | ] |
| | 648 | ], |
| | 649 | "msg": "", |
| | 650 | "page": 1, |
| | 651 | "ret": 0, |
| | 652 | "size": 1, |
| | 653 | "total": 6220 |
| | 654 | } |
| | 655 | }}} |
| | 656 | |
| | 657 | === 5.9. web端“评论详情”页面需要根据需求调整=== |
| | 658 | 备注:修改原有web“评论详情”页面 \\ |
| | 659 | |
| | 660 | === 5.10. web端“评论详情”页面点赞的效果如需要客户端原生实现,需要定义响应事件=== |
| | 661 | === 5.11. web端“专业评测文章”页面需要根据需求修改=== |
| | 662 | 备注:修改原有web“专业评测文章”页面 \\ |
| | 663 | === 5.12. “找美妆-按功效”接口=== |
| | 664 | 备注:新增接口,找美妆-按功效。 \\ |
| | 665 | 请求URL:http://cosme.pclady.com.cn/interface/app/v2/search_effect.jsp \\ |
| | 666 | HTTP请求方式:GET \\ |
| | 667 | 是否需要登录:否 \\ |
| | 668 | 返回格式:json \\ |
| | 669 | 缓存方式:* \\ |
| | 670 | 缓存时间:* \\ |
| | 671 | 请求参数:无 \\ |
| | 672 | 请求后端URL:* \\ |
| | 673 | 请求后端参数:* \\ |
| | 674 | 返回 \\ |
| | 675 | {{{ |
| | 676 | { |
| | 677 | "data": [ //数组, 分类列表 |
| | 678 | { |
| | 679 | "hots" : [ //数组, 分类下的热门分类列表 |
| | 680 | [ |
| | 681 | { |
| | 682 | "id": 1, //int, ID |
| | 683 | "name": "", //string, 名称 |
| | 684 | "q": "", //string, 名称 |
| | 685 | "img": "" //url, 图片URL |
| | 686 | } |
| | 687 | ], |
| | 688 | [ |
| | 689 | { |
| | 690 | "id": 1, //int, ID |
| | 691 | "name": "", //string, 名称 |
| | 692 | "q": "", //string, 名称 |
| | 693 | "img": "" //url, 图片URL |
| | 694 | } |
| | 695 | ], |
| | 696 | [ |
| | 697 | { |
| | 698 | "id": 1, //int, ID |
| | 699 | "name": "", //string, 名称 |
| | 700 | "q": "", //string, 名称 |
| | 701 | "img": "" //url, 图片URL |
| | 702 | } |
| | 703 | ] |
| | 704 | ], |
| | 705 | "children": [ //数组, 分类下的子分类 |
| | 706 | { |
| | 707 | "id": 1, //int, ID |
| | 708 | "name": "", //string, 名称 |
| | 709 | "q": "" //string, 名称 |
| | 710 | } |
| | 711 | ], |
| | 712 | "id": 1, //int, 类别ID |
| | 713 | "name": "" //string, 类别名 |
| | 714 | } |
| | 715 | ], |
| | 716 | "msg": "", |
| | 717 | "ret": 0 |
| | 718 | } |
| | 719 | }}} |
| | 720 | === 5.13. “搜索与榜单”接口=== |
| | 721 | 备注:修改接口,原list接口修改支持“按效果获取列表数据” \\ |
| | 722 | 请求URL:http://cosme.pclady.com.cn/interface/app/v2/list.jsp \\ |
| | 723 | HTTP请求方式:GET \\ |
| | 724 | 是否需要登录:否 \\ |
| | 725 | 返回格式:json \\ |
| | 726 | 缓存方式:* \\ |
| | 727 | 缓存时间:* \\ |
| | 728 | 请求参数: \\ |
| | 729 | {{{ |
| | 730 | type //int, 接口类型, 1:搜索接口, 2:榜单接口 |
| | 731 | key //string, 搜索关键字, 如果是榜单入口, 值为榜单名字 |
| | 732 | q //string, 索引信息字段, 用于榜单分类 |
| | 733 | sort //int, 排序方式, 1:分数, 2:人气, 3:最新, 4:价格高, 5:价格底 |
| | 734 | page //int, 页数 |
| | 735 | size //int, 每页条数 |
| | 736 | }}} |
| | 737 | |
| | 738 | 请求后端URL:* \\ |
| | 739 | 请求后端参数:* \\ |
| | 740 | 返回格式:json \\ |
| | 741 | |
| | 742 | {{{ |
| | 743 | { |
| | 744 | "list": [ |
| | 745 | { |
| | 746 | "brand": "", //string, 品牌 |
| | 747 | "c_count": 1478, //int, 评论数 |
| | 748 | "id": "85099", //string, 产品ID, 用于拼装产品详情页面URL |
| | 749 | "img_l": "", //url, 大图 |
| | 750 | "img_s": "", //url, 小图 |
| | 751 | "name": "", //string, 产品名称 |
| | 752 | "price": 210, //float, 价格 |
| | 753 | "score": 8.5, //float, 评分 |
| | 754 | "type": [ //数组, 评测类型, 用于评测终端页 |
| | 755 | { |
| | 756 | "id": "20", //string, 评测类型ID |
| | 757 | "name": "" //string, 评测类型名称 |
| | 758 | } |
| | 759 | ], |
| | 760 | "url": "" //url, 详情页面URL |
| | 761 | } |
| | 762 | ], |
| | 763 | "q_list": [ //数组, 索引信息字段, 用于榜单分类 |
| | 764 | { |
| | 765 | "count": 4786, //int, 结果数量 |
| | 766 | "q": "深层清洁" //同上 |
| | 767 | } |
| | 768 | ], |
| | 769 | "msg": "", |
| | 770 | "page": 1, |
| | 771 | "ret": 0, |
| | 772 | "size": 1, |
| | 773 | "total": 7118 |
| | 774 | } |
| | 775 | }}} |
| | 776 | |
| | 777 | === 5.14. “品牌馆”接口 === |
| | 778 | 备注:修改“品牌馆接口”,增加已加心数量字段 \\ |
| | 779 | |
| | 780 | 请求URL:http://cosme.pclady.com.cn/interface/app/v2/brands.jsp \\ |
| | 781 | HTTP请求方式:GET \\ |
| | 782 | 是否需要登录:否 \\ |
| | 783 | 返回格式:json \\ |
| | 784 | 缓存方式:* \\ |
| | 785 | 缓存时间:* \\ |
| | 786 | 请求参数:无 \\ |
| | 787 | 请求后端URL:* \\ |
| | 788 | 请求后端参数:* \\ |
| | 789 | 返回格式:json\\ |
| | 790 | |
| | 791 | {{{ |
| | 792 | { |
| | 793 | "hots": [ //数组, 热门品牌 |
| | 794 | [ |
| | 795 | { |
| | 796 | "id": "", //string, 品牌ID |
| | 797 | "logo": "", //url, 品牌logo图标 |
| | 798 | "name": "" //string, 品牌名称 |
| | 799 | } |
| | 800 | ] |
| | 801 | ], |
| | 802 | "list": [ //数组 |
| | 803 | { |
| | 804 | "group": [ //数组, 同一索引字符下的品牌 |
| | 805 | { |
| | 806 | "id": "", //string, 品牌ID |
| | 807 | "name": "", //string, 品牌名称 |
| | 808 | "tag_id": 0 //int, 标签ID, 与tag中的id对应 |
| | 809 | } |
| | 810 | ], |
| | 811 | "index": "" //char, 索引字符 |
| | 812 | } |
| | 813 | ], |
| | 814 | "tags": [ //数组, 返回的分类标签 |
| | 815 | { |
| | 816 | "id": 0, //int, 标签ID |
| | 817 | "name": "" //string, 标签名称 |
| | 818 | } |
| | 819 | ], |
| | 820 | "msg": "", |
| | 821 | "ret": 0 |
| | 822 | } |
| | 823 | }}} |
| | 824 | |
| | 825 | === 5.15. “品牌列表”接口 === |
| | 826 | 备注:修改“品牌列表接口”,支持“按分类筛选” \\ |
| | 827 | 请求URL:http://cosme.pclady.com.cn/interface/app/v2/brand_list.jsp \\ |
| | 828 | HTTP请求方式:GET \\ |
| | 829 | 是否需要登录:否 \\ |
| | 830 | 返回格式:json \\ |
| | 831 | 缓存方式:* \\ |
| | 832 | 缓存时间:* \\ |
| | 833 | 请求参数: \\ |
| | 834 | {{{ |
| | 835 | id //品牌ID |
| | 836 | sub_id //子品牌ID |
| | 837 | category_id //分类ID |
| | 838 | page //int, 页数 |
| | 839 | size //int, 每页条数 |
| | 840 | }}} |
| | 841 | |
| | 842 | 请求后端URL:* \\ |
| | 843 | 请求后端参数:* \\ |
| | 844 | 返回 \\ |
| | 845 | {{{ |
| | 846 | { |
| | 847 | "cn_name": "", //string, 中文名 |
| | 848 | "en_name": "", //string, 英文名 |
| | 849 | "from": "法国", //string, 发源地 |
| | 850 | "logo": "", //url, 品牌logo |
| | 851 | "list": [ //数组, 列表 |
| | 852 | { |
| | 853 | "brand": "", //string, 品牌名称 |
| | 854 | "c_count": 4315, //int, 评论数 |
| | 855 | "id": "98275", //string, 产品ID, 用于拼装产品详情页面URL |
| | 856 | "img_l": "", //url, 大图 |
| | 857 | "img_s": "", //url, 小图 |
| | 858 | "name": " ", //string, 产品名称 |
| | 859 | "price": 140, //float, 价格 |
| | 860 | "score": 8.3, //float, 评分 |
| | 861 | "type": [ //数组, 评测类型, 用于评测终端页 |
| | 862 | { |
| | 863 | "id": "20", //string, 评测类型ID |
| | 864 | "name": "" //string, 评测类型名称 |
| | 865 | } |
| | 866 | ], |
| | 867 | "url": "http://cosme.pclady.com.cn/product/98275.html" |
| | 868 | } |
| | 869 | ], |
| | 870 | "sub": [ //数组, 分类列表 |
| | 871 | { |
| | 872 | "id": "70", //string, 分类ID |
| | 873 | "name": "" //string, 分类名称 |
| | 874 | } |
| | 875 | ], |
| | 876 | "category": [ //数组, 类别列表 |
| | 877 | { |
| | 878 | "id": "70", //string, 类别ID |
| | 879 | "name": "" //string, 类别名称 |
| | 880 | } |
| | 881 | ], |
| | 882 | "msg": "", |
| | 883 | "page": 1, |
| | 884 | "ret": 0, |
| | 885 | "size": 1, |
| | 886 | "total": 474 |
| | 887 | } |
| | 888 | }}} |
| | 889 | |
| | 890 | === 5.16. 肤质测试报告页面整合对应解决功效产品榜单Top3(web页面) === |
| | 891 | |
| | 892 | === 5.17. 肤质拯救方案页面(web页面或者数据接口)=== |
| | 893 | |
| | 894 | === 5.18. “试用列表”(正在进行、即将开始)=== |
| | 895 | 备注:获取试用列表接口\\ |
| | 896 | |
| | 897 | 请求URL:http://cosme.pclady.com.cn/interface/app/v2/trial_list.jsp \\ |
| | 898 | HTTP请求方式:GET \\ |
| | 899 | 是否需要登录:否 \\ |
| | 900 | 返回格式:json \\ |
| | 901 | 缓存方式:* \\ |
| | 902 | 缓存时间:* \\ |
| | 903 | 请求参数: \\ |
| | 904 | {{{ |
| | 905 | tag // 0: 正在进行, 1: 即将开始 |
| | 906 | page // 页数 |
| | 907 | size // 每页数量 |
| | 908 | }}} |
| | 909 | |
| | 910 | 请求后端URL:* \\ |
| | 911 | 请求后端参数:* \\ |
| | 912 | 返回 \\ |
| | 913 | {{{ |
| | 914 | { |
| | 915 | "list": [ //数组, 列表 |
| | 916 | { |
| | 917 | "id": "98275", //string, 试用项ID |
| | 918 | "img": "", //url, 图片 |
| | 919 | "name": " ", //string, 产品名称 |
| | 920 | "price": 140, //float, 价格 |
| | 921 | "model": "", //string, 规格 |
| | 922 | "count": 20, //int, 试用品份数 |
| | 923 | "time": "" //string,试用结束时间 |
| | 924 | } |
| | 925 | ], |
| | 926 | "msg": "", |
| | 927 | "page": 1, |
| | 928 | "ret": 0, |
| | 929 | "size": 1, |
| | 930 | "total": 474 |
| | 931 | } |
| | 932 | }}} |
| | 933 | |
| | 934 | === 5.19. “试用详情”接口 === |
| | 935 | 备注:试用详情页接口,正在进行的试用才有 \\ |
| | 936 | 请求URL:http://cosme.pclady.com.cn/interface/app/v2/trial_detail.jsp \\ |
| | 937 | HTTP请求方式:GET \\ |
| | 938 | 是否需要登录:否 \\ |
| | 939 | 返回格式:json \\ |
| | 940 | 缓存方式:* \\ |
| | 941 | 缓存时间:* \\ |
| | 942 | 请求参数:\\ |
| | 943 | {{{ |
| | 944 | id // 试用项ID |
| | 945 | }}} |
| | 946 | |
| | 947 | 请求后端URL:* \\ |
| | 948 | 请求后端参数:* \\ |
| | 949 | 返回 \\ |
| | 950 | {{{ |
| | 951 | { |
| | 952 | "data": { |
| | 953 | "id": "98275", //string, 试用项ID |
| | 954 | "img": "", //url, 图片 |
| | 955 | "name": " ", //string, 产品名称 |
| | 956 | "model": "", //string, 规格 |
| | 957 | "price": 140, //float, 价格 |
| | 958 | "count": 20, //int, 试用品份数 |
| | 959 | "time": "", //string,试用结束时间 |
| | 960 | "t_count": 20, //int, 申请人数 |
| | 961 | "instructions": [ //数组, 试用说明 |
| | 962 | { |
| | 963 | "title": "", //string, 标题 |
| | 964 | "desc": "" //string, 描述 |
| | 965 | } |
| | 966 | ] |
| | 967 | }, |
| | 968 | "msg": "", |
| | 969 | "ret": 0 |
| | 970 | } |
| | 971 | }}} |
| | 972 | |
| | 973 | === 5.20. “申请试用提交”接口 === |
| | 974 | 备注: \\ |
| | 975 | 请求URL:http://cosme.pclady.com.cn/interface/app/v2/apply_trial.jsp \\ |
| | 976 | HTTP请求方式:POST \\ |
| | 977 | 是否需要登录:否 \\ |
| | 978 | 返回格式:json \\ |
| | 979 | 缓存方式:* \\ |
| | 980 | 缓存时间:* \\ |
| | 981 | 请求参数: \\ |
| | 982 | {{{ |
| | 983 | id //试用项ID |
| | 984 | name //申请者姓名 |
| | 985 | address //申请者地址 |
| | 986 | phone //申请者手机 |
| | 987 | email //申请者邮箱 |
| | 988 | userId//用户ID |
| | 989 | }}} |
| | 990 | 请求后端URL:* \\ |
| | 991 | 请求后端参数:* \\ |
| | 992 | 返回 \\ |
| | 993 | {{{ |
| | 994 | { |
| | 995 | "msg": "", |
| | 996 | "ret": 0 |
| | 997 | } |
| | 998 | }}} |
| | 999 | |
| | 1000 | === 5.21. “我的肤质、试用、收藏、点评”获取接口 === |
| | 1001 | 备注: \\ |
| | 1002 | 请求URL:http://cosme.pclady.com.cn/interface/app/v2/uer_info.jsp \\ |
| | 1003 | HTTP请求方式:GET \\ |
| | 1004 | 是否需要登录:是 \\ |
| | 1005 | 返回格式:json \\ |
| | 1006 | 缓存方式:* \\ |
| | 1007 | 缓存时间:* \\ |
| | 1008 | 请求参数: \\ |
| | 1009 | {{{ |
| | 1010 | userId //用户ID |
| | 1011 | type //数据类型 0:肤质,1:试用,2:收藏,3:点评 |
| | 1012 | page //页数 |
| | 1013 | size //每页数量 |
| | 1014 | }}} |
| | 1015 | |
| | 1016 | 请求后端URL:* \\ |
| | 1017 | 请求后端参数:* \\ |
| | 1018 | 返回 \\ |
| | 1019 | {{{ |
| | 1020 | { |
| | 1021 | "data" : { //type为0, 数组为皮肤测试数据 |
| | 1022 | "list": [ |
| | 1023 | { |
| | 1024 | "id": "", //string, 肤质测试ID |
| | 1025 | "img": "", //url, 测试肤质图URL |
| | 1026 | "time": "", //date |
| | 1027 | "score": 99.98 //float, 分数 |
| | 1028 | } |
| | 1029 | ] |
| | 1030 | }, |
| | 1031 | "data" : { //type为1, 数组为试用数据 |
| | 1032 | "list": [ |
| | 1033 | { |
| | 1034 | "id": "98275", //string, 试用项ID |
| | 1035 | "img": "", //url, 图片 |
| | 1036 | "name": " ", //string, 产品名称 |
| | 1037 | "time": "", //date, 申请时间 |
| | 1038 | "status": 0 //int, 申请状态, 0:审核中, 1:已获得试用 |
| | 1039 | } |
| | 1040 | ], |
| | 1041 | "trials": 99, //int, 已申请试用, type为1时才有 |
| | 1042 | "winning": 98, //int, 已中奖试用, type为1时才有 |
| | 1043 | }, |
| | 1044 | "data" : { //type为2, 数组为试用数据 |
| | 1045 | "brand": [ |
| | 1046 | { |
| | 1047 | "id": "98275", //string, 品牌ID |
| | 1048 | "img": "", //url, 图片 |
| | 1049 | } |
| | 1050 | ], |
| | 1051 | "fav": [ |
| | 1052 | { |
| | 1053 | "id": "98275", //string, 产品ID |
| | 1054 | "img": "", //url, 图片 |
| | 1055 | "name": "", //string, 产品名称 |
| | 1056 | "score": 9.9 //float, 分数 |
| | 1057 | } |
| | 1058 | ] |
| | 1059 | }, |
| | 1060 | "data" : { //type为3, 数组为点评数据 |
| | 1061 | "list": [ |
| | 1062 | { |
| | 1063 | "id": "98275", //string, 评论ID |
| | 1064 | "productId": "",//string, 被评论产品ID |
| | 1065 | "img": "", //url, 图片 |
| | 1066 | "name": " ", //string, 产品名称 |
| | 1067 | "desc": "", //string, 评论内容 |
| | 1068 | "status": 0 //int, 评论状态, 0:审核中, 1:审核通过, 2:审核不通过 |
| | 1069 | } |
| | 1070 | ], |
| | 1071 | "general": 99, //int, 普通 |
| | 1072 | "digest": 98, //int, 精华 |
| | 1073 | "unpass": 1, //int, 不通过 |
| | 1074 | }, |
| | 1075 | "type": 0, //int, 数组类型, 0:肤质,1:试用,2:收藏,3:点评 |
| | 1076 | "msg": "", |
| | 1077 | "ret": 0 |
| | 1078 | } |
| | 1079 | }}} |
| | 1080 | |
| | 1081 | === 5.22. “我的肤质”提交接口 === |
| | 1082 | 备注: \\ |
| | 1083 | 请求URL:http://cosme.pclady.com.cn/interface/app/v2/skin_submit.jsp \\ |
| | 1084 | HTTP请求方式:POST \\ |
| | 1085 | 是否需要登录:是 \\ |
| | 1086 | 返回格式:json \\ |
| | 1087 | 缓存方式:* \\ |
| | 1088 | 缓存时间:* \\ |
| | 1089 | 请求参数: \\ |
| | 1090 | {{{ |
| | 1091 | userId //用户ID |
| | 1092 | id //肤质测试ID |
| | 1093 | img //测试肤质图 |
| | 1094 | time //date |
| | 1095 | score //分数 |
| | 1096 | }}} |
| | 1097 | 请求后端URL:* \\ |
| | 1098 | 请求后端参数:* \\ |
| | 1099 | 返回 \\ |
| | 1100 | {{{ |
| | 1101 | { |
| | 1102 | "msg": "", |
| | 1103 | "ret": 0 |
| | 1104 | } |
| | 1105 | }}} |
| | 1106 | |
| | 1107 | === 5.23. “我的试用”提交接口 === |
| | 1108 | 备注: \\ |
| | 1109 | 请求URL:http://cosme.pclady.com.cn/interface/app/v2/trial_submit.jsp \\ |
| | 1110 | HTTP请求方式:POST \\ |
| | 1111 | 是否需要登录:是 \\ |
| | 1112 | 返回格式:json \\ |
| | 1113 | 缓存方式:* \\ |
| | 1114 | 缓存时间:* \\ |
| | 1115 | 请求参数:\\ |
| | 1116 | {{{ |
| | 1117 | userId //用户ID |
| | 1118 | id //试用ID |
| | 1119 | }}} |
| | 1120 | |
| | 1121 | 请求后端URL:* \\ |
| | 1122 | 请求后端参数:* \\ |
| | 1123 | 返回格式:json\\ |
| | 1124 | {{{ |
| | 1125 | { |
| | 1126 | "msg": "", |
| | 1127 | "ret": 0 |
| | 1128 | } |
| | 1129 | }}} |
| | 1130 | |
| | 1131 | === 5.24. “我的收藏”提交接口 === |
| | 1132 | 备注:\\ |
| | 1133 | 请求URL:http://cosme.pclady.com.cn/interface/app/v2/fav_submit.jsp \\ |
| | 1134 | HTTP请求方式:POST \\ |
| | 1135 | 是否需要登录:是 \\ |
| | 1136 | 返回格式:json \\ |
| | 1137 | 缓存方式:* \\ |
| | 1138 | 缓存时间:* \\ |
| | 1139 | 请求参数: \\ |
| | 1140 | {{{ |
| | 1141 | userID //用户ID |
| | 1142 | id //产品ID |
| | 1143 | }}} |
| | 1144 | 请求后端URL:* \\ |
| | 1145 | 请求后端参数:* \\ |
| | 1146 | 返回 \\ |
| | 1147 | {{{ |
| | 1148 | { |
| | 1149 | "msg": "", |
| | 1150 | "ret": 0 |
| | 1151 | } |
| | 1152 | }}} |
| | 1153 | |
| | 1154 | === 5.25. “提交试用报告”接口 === |
| | 1155 | 备注: \\ |
| | 1156 | 请求URL:http://cosme.pclady.com.cn/interface/app/v2/trial_report_submit.jsp \\ |
| | 1157 | HTTP请求方式:POST \\ |
| | 1158 | 是否需要登录:否 \\ |
| | 1159 | 返回格式:json \\ |
| | 1160 | 缓存方式:* \\ |
| | 1161 | 缓存时间:* \\ |
| | 1162 | 请求参数: \\ |
| | 1163 | {{{ |
| | 1164 | id //试用条目ID |
| | 1165 | score //赞: 0、中立: 1、踩: 2 |
| | 1166 | title //标题 |
| | 1167 | desc //描述 |
| | 1168 | images //图片 |
| | 1169 | }}} |
| | 1170 | 请求后端URL:* \\ |
| | 1171 | 请求后端参数:* \\ |
| | 1172 | 返回 \\ |
| | 1173 | {{{ |
| | 1174 | { |
| | 1175 | "msg": "", |
| | 1176 | "ret": 0 |
| | 1177 | } |
| | 1178 | }}} |