业务接口

介绍 卡游售卖机开放平台 提供的业务接口

抽卡机场地相关

分页获取场地列表

使用 client_credentials 模式,获取accessToken后进行接口调用

GET /api/sites/list

  • 请求参数

    • Header:
    参数名称参数值是否必填示例备注
    AuthorizationBearer 12f7764bd76e4350bd87772390444d7cBearer 12f7764bd76e4350bd87772390444d7cBearer accessToken
    page11页码从1开始
    pageSize1010默认10
  • 返回数据

    名称类型是否必须备注
    codeNumber返回码
    msgString返回信息
    timestampNumber时间戳
    resultobject
    itemsArray
    codeString编码
    nameString名称
    stateInteger状态:1启用 0未启用
    openTimeInteger开始营业时间
    closeTimeInteger结束营业时间
    addressInteger地址
    addressExtInteger扩展地址
    lngInteger经度
    latInteger纬度
    imgsArray门面图
    totalInteger
  • 返回说明

    • 正确的返回:
        {
            "result": {
                "items": [{
                    "code": "CD000077",
                    "name": "1010出货测试场地",
                    "siteType": "default",
                    "state": 1,
                    "openTime": "09:00:00",
                    "closeTime": "22:00:00",
                    "address": "上海市闵行区吴中路1588号",
                    "addressExt": "",
                    "lng": "121.372544",
                    "lat": "31.174052",
                    "imgs": []
                }],
                "total": 62
            },
            "code": 0,
            "type": "success",
            "message": "操作成功",
            "timestamp": 1665970440
        }
    
    • 错误的返回:
        {
            "code": 500,
            "msg": "token is timeout. please retry.",
            "timestamp": 1608008002
        }