膜纸列表查询

最后更新时间:2023-05-25

请求

基本信息

基本
正式 DOMAINhttps://open.bianxingjimu.com
测试 DOMAINhttps://open.tb.tokoyi.com
PATH/api/v1/filmPaper/listAll
HTTP MethodPOST
调用方式第三方调用TB

请求头

名称类型必填描述
Authorizationstring值格式:"TB TbTestAccessKeyId:`access_token`"

示例值:"TB TbTestAccessKeyId:JuMYM0eWev33g1H4yZguXP026HCnaorOGQC3nAh4rU4="

Content-Typestring固定值:"application/json"
Datestring请求时间,仅支持GMT格式

请求体

名称类型必填说明
film_paper_numberstringTB膜纸编码
film_paper_supplier_numberstring供应商膜纸编码
pageint分页
limitint每页条数(默认20条)

请求体示例

json
{
"film_paper_number": "TB-FC-G7076-859E-M2",
"film_paper_supplier_number": "TJ-F9391-804A-P5",
"page": 1,
"limit": 20
}

响应

响应头

名称类型必须描述
Content-Typestring固定值:"application/json"
X-Tb-LogIdstring日志ID

示例值:"2021092309572286544XFCO1143"

响应体

参数类型说明
codeint错误码,非200表示失败
msgstring返回码的描述
datamap返回业务信息
    ∟listmap膜纸列表
        ∟film_paper_namestring膜纸名称
        ∟film_paper_numberstringTB膜纸编码
        ∟film_paper_supplier_numberstring供应商膜纸编码
        ∟film_paper_material_qualitystring膜纸材质 (有为空情况)
        ∟film_paper_picturestring膜纸图片 (有为空情况)
    ∟totalint总条数
    ∟current_pagemap当前页码
    ∟last_pagemap末尾页码

200响应体示例

json
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"film_paper_name": "都灵灰",
"film_paper_number": "TB-FC-G7076-859E-M2",
"film_paper_supplier_number": "TJ-F9391-804A-P5",
"film_paper_material_quality": "PVC",
"film_paper_picture": "https://oss.tb.tokoyi.com/wallboard-skin/v2/TB-FC-G7076-859E-M2.jpg"
}
],
"total": 1,
"current_page": 1,
"last_page": 1
}
}

403响应体示例

json
{
"code": 403,
"msg": "信息录入错误",
"data": []
}

400响应体示例

json
{
"code": 400,
"msg": "page格式错误",
"data": []
}

错误码

HTTP状态码业务状态码解释对应msg信息
200200成功SUCCESS
200400参数录入错误
200403token错误