dangdang.activity.findActivitiesByCreateria

根据各种条件查询活动列表

  • 该接口根据各种查询条件分页查找促销列表,查询条件中包含促销id,起止时间,促销状态,促销审核状态,促销类型.

    版本:2.0


  • 接口入参包含两部分:

    第一部分:url上?后边跟shopId=?(商家店铺id)

    第二部分:以表单形式提交post请求,表单中只有一个键值对,name=stringEntity,value的说明如下:


    {
        "activityPageSearchCriteria": {
                 //促销条件的封装"activityDataSource": "ACTIVITY",
                  //数据源,ACTIVITY查30天之内的促销,ACTIVITY_HISTORY查询结束超过30天的促销"activityIdList": [//想要查询的促销id3312234,
                  3312235],
                  "activityStatusList": [//促销的状态,当不关心状态的时候这个节点为空"BEFORE_START",
                  //未开始"RUNNING",
                 //正在进行中"ENDED"//已结束],
                  "reviewStatusList": [//审核状态,当不关心审核状态的时候,这个节点为空"WITHOUT_REVIEW",
                  //待审核"REVIEW_REJECT",
                  //审核不通过"REVIEW_PASS"//审核通过],
                  "activitySubTypeList": [//促销类型102,
                  20]
        },
         "pagination": {
                "pageCount": 1,
                  //每页多少个"currentPage": 1//第几页
        }
    }


  • 接口入参包含两部分:

    第一部分:url上?后边跟shopId=?(商家店铺id)

    第二部分:以表单形式提交post请求,表单中只有一个键值对,name=stringEntity,value的说明如下:

    {
        activityPageSearchCriteria: {
            activityDataSource: "ACTIVITY", 
            activityIdList: [
                3312234, 
                3312235
            ]
        }, 
        pagination: {
            pageCount: 1, 
            currentPage: 1
        }
    }


  • 返回的是个json格式的字符串。

    {

        "code": "-1",//接口是否返回正确,0代表响应成功,-1代表响应失败
        "errors": [//响应失败的原因,当code=0的时候,这个节点为null。
            {
                "code": 1,//错误码
                "message": "详细错误原因1"//错误原因
            },
            {
                "code": 2,
                "message": "详细错误原因2"
            }
    ],
    "response": {//具体的响应,当code=-1的时候,这个节点为null
            "pageCount": 1,
            "currentPage": 1,
            "totalCount": 2,
            "records": [
                {
                    "id": 3312234,//促销id
                    "deleted": false,//促销是否存在,true表示删除状态
                    "creationDate": 1467019698000,//创建时间的毫秒值
                    "lastChangedDate": 1481012207000,//最后修改时间的毫秒值
                    "shopId": 13639,//促销所在的店铺id
                    "activityName": "良乐屋促销",//促销名字
                    "activityType": "COMMON_PROMO",//固定值,COMMON_PROMO代表日常促销
                    "activitySubType": 102,//促销类型
                    "activityCreateType": "Normal",//固定值,Normal代表自己创建的
                    "activityStatus": "RUNNING",//促销状态,RUNNING表示正在进行中。
                    "reviewStatus": "REVIEW_PASS",//审核状态
                    "startDate": 1467020400000,//促销开始时间的毫秒值
                    "endDate": 1482489600000,//促销结束时间的毫秒值
                    "createdBy": "130474088",//创建者
                    "lastChangedBy": "130474088",//最后修改者
                    "activityProductBatch": {//最后一次提报的品批次信息
                        "id": 1517265,//批次id
                        "deleted": false,//是否有效
                        "creationDate": 1481012207000,//创建时间的毫秒值
                        "lastChangedDate": 1481012208000,//最后修改时间的毫秒值
                        "activityId": 3312234,//关联的促销id
                        "operationType": "MODIFY_PRODUCT",//上一次的操作类型,MODIFY_PRODUCT代表修改商品,ADD_PRODUCT代表新增商品,REMOVE_PRODUCT代表删除商品
                        "userId": 212322,//操作人id
                        "status": 1,//审核状态,1代表审核完成,0代表待审核
                        "productsNum": 0//上一次提报的品数量
                    }
                }
            ],
            "pageCountTypeList": [
                "TWO_OF_A_PAGE",
                "TEN_OF_A_PAGE",
                "TWENTY_OF_A_PAGE",
                "FIFTY_OF_A_PAGE",
                "ONE_HUNDRED_OF_A_PAGE",
                "TWO_HUNDRED_OF_A_PAGE",
                "FIVE_HUNDRED_OF_A_PAGE"
            ],
            "offset": 0,//本页第一个元素在库中是第几个。无需关心。
            "showPages": [//结果分布在这几页,无需关心。
                1,
                2
            ],
            "pages": 2,//一共多少页
            "havePrevious": false,//前面是否还有
            "haveNext": true//是否还有下一页
        }
    }


  • {
        "code": "-1",
        "errors": [{
            "code": 1,
            "message": "详细错误原因1"
             },
            {
            "code": 2,
            "message": "详细错误原因2"
        }],
         “response”: null

    }

  • {
        "code": "0",
        "errors": null,
        "response": {
            "pageCount": 1,
            "currentPage": 1,
            "totalCount": 2,
            "records": [
                {
                    "id": 3312234,
                    "deleted": false,
                    "creationDate": 1467019698000,
                    "lastChangedDate": 1481012207000
                    "shopId": 13639,
                    "activityName": "良乐屋促销",
                    "activityTag": null,
                    "activityType": "COMMON_PROMO",
                    "activitySubType": 102,
                    "activityCreateType": "Normal",
                    "activityStatus": "RUNNING",
                    "reviewStatus": "REVIEW_PASS",
                    "startDate": 1467020400000,
                    "endDate": 1482489600000,
                    "createdBy": "130474088",
                    "lastChangedBy": "130474088"
                    "activityProductBatch": {
                        "id": 1517265,
                        "deleted": false,
                        "creationDate": 1481012207000,
                        "lastChangedDate": 1481012208000,
                        "activityId": 3312234,
                        "operationType": "MODIFY_PRODUCT",
                        "userId": null,
                        "status": 1,
                        "productsNum": 0
                    }
                }
            ],
            "pageCountTypeList": [
                "TWO_OF_A_PAGE",
                "TEN_OF_A_PAGE",
                "TWENTY_OF_A_PAGE",
                "FIFTY_OF_A_PAGE",
                "ONE_HUNDRED_OF_A_PAGE",
                "TWO_HUNDRED_OF_A_PAGE",
                "FIVE_HUNDRED_OF_A_PAGE"
            ],
            "offset": 0,
            "showPages": [
                1,
                2
            ],
            "pages": 2,
            "havePrevious": false,
            "haveNext": true
        }
    }