CFT-周大福

等级查询

POST

/fast-service/v1/0.0/api/grade/get

等级场景

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api-vpjq75s2e4.kylin.shuyun.com/fast-service/v1/0.0/api/grade/get' \
--header 'Authorization;' \
--header 'X-Caller-Service: ' \
--header 'X-Caller-sign: ' \
--header 'X-Caller-Timestamp: ' \
--header 'X-Caller-Sign: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "bizCode": "CTFCN",
    "requestChannel": "POS",
    "requestSystem": "POS",
    "transactionId": "",
    "identify": {
        "memberId": "CTF0124122300000006"
    },
    "gradeBizType": "GRADE"
}'

响应示例

{
  "success": true,
  "code": "000000",
  "message": "成功",
  "data": {
    "memberId": "CTF0124122300000010",
    "id": 60092,
    "name": "Tier2",
    "effectTime": "2024-12-24 18:46:16",
    "expiredTime": "2025-12-31 23:59:59",
    "nextGradeId": "60093",
    "nextGradeName": "Tier3",
    "currentUpGradeQs": 0,
    "currentKeepGradeQs": 0,
    "upGradeNeededQs": 25000,
    "keepGradeNeededQs": 2500,
    "lastOrderTime": null
  }
}

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Authorization

string

必需

默认值:

Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJicmFuY2hfMzgxMCIsImF1ZCI6InNtYXJ0X3BvcnRhbF91YXQiLCJpc3MiOiJzc28iLCJpcF9hZGRyZXNzIjoiMTAuMjAwLjE4MC43NiIsImV4cCI6MTczOTc5ODIzMCwiYnJhbmNoIjoiMzgxMCIsImlhdCI6MTczOTc5MTAzMH0.jqwTnQ0ah3k94Yjpn7hw91QtmKwsvXhjyibZpXDrGifaBcvzPdz8MjCg66FUohyKTS4ciZILl6xXJ5a1pQ_iIg

X-Caller-Service

string

可选

默认值:

X-Caller-sign

string

可选

默认值:

X-Caller-Timestamp

string

可选

默认值:

X-Caller-Sign

string

网关签名

可选

默认值:

Body 参数application/json

bizCode

string

业务代码

必需

>= 1 字符

示例值:

CTFCN

requestChannel

string

请求渠道 POS;WECHAT:微信

必需

>= 1 字符

示例值:

WECHAT

requestSystem

string

请求系统 POS;WECHAT_MALL:微信商城;MEMBER_CENTER:会员中心;POINTS_MALL:积分商城

必需

>= 1 字符

示例值:

WECHAT_MALL

transactionId

string

事务ID

必需

>= 1 字符

示例值:

TX2024030490569

identify

object

必需

memberId

string

麒麟会员ID

可选

channel

string

识别渠道 POS;WECHAT:微信非必输(如果不传默认取requestChannel)

可选

userId

string

渠道用户id。POS渠道:pos卡号(不能为手机号);微信:appId_openId;淘宝渠道:ouid;京东:xid;抖店:openid.其他渠道唯一id等等

可选

示例值:

wxd678efh567hg6787_oGPAG5rdBP78jh_3cmJ1en8FvZlo

gradeBizType

string

等级业务类型,不传,默认为: GRADE

可选

默认值:

GRADE

示例

返回响应

🟢200get_1 200 response

application/json

Body

success

boolean

是否成功：true 表示成功 false 表示失败

必需

code

string

000000 表示成功，其余编码表示具体错误编码

必需

message

string

必需

data

object

必需

memberId

string

GlobalID

必需

integer

当前等级ID

必需

name

string

当前等级名称

必需

effectTime

string

当前等级生效时间

必需

expiredTime

string

当前等级过期时间

必需

nextGradeId

string

下一等级ID

必需

nextGradeName

string

下一等级名称

必需

currentUpGradeQs

integer

当前升级QS

必需

currentKeepGradeQs

integer

当前续约QS

必需

upGradeNeededQs

integer

升级所需QS

必需

keepGradeNeededQs

integer

保级所需QS

必需

lastOrderTime

string

最后一次消费时间

可选

查询等级配置列表

明细查询