cg-api

GET /api/v2/certs/(gia|GIA)/(\w+)

查询证书信息(GIA)

GET /api/v2/certs/(gia|GIA)/(\d+).pdf

证书PDF（GIA）

GET /api/v2/certs/(gia|GIA)/(\w+).pdf

证书PDF（GIA） uuid 方式

GET /api/v2/certs/(gia|GIA)/(\d+).jpg

证书JPG（GIA）

GET /api/v2/certs/(gia|GIA)/(\w+).jpg

证书JPG（GIA）

GET /api/v2/certs/(igi|IGI)/(\w+)

获取IGI证书

GET /api/v2/certs/(igi|IGI)/(\d+).pdf

证书PDF（IGI）

GET /api/v2/certs/(igi|IGI)/(\w+).pdf

证书PDF（IGI）

GET /api/v2/certs/(igi|IGI)/(\d+).jpg

证书JPG（IGI）

GET /api/v2/certs/(igi|IGI)/(\w+).jpg

证书JPG（IGI）

GET /api/v2/certs/(ngtc|NGTC|hrd|HRD|egl|EGL)/(\w+)

获取证书信息

POST /api/v2/dpi2/costcalculator/prices-adjuster

价格筛选器/成本核算器/预售调价器

POST /api/v2/dpi2/costcalculator/by-grain

价格筛选器/成本核算器/预售调价器

POST /api/v2/dpi2/costcalculator/by-return

价格筛选器/成本核算器/预售调价器

POST /api/v2/dpi/costcalculator/dpi-prices

获取指定货型的最低价

获得指定供应商的一些货型的最低价

ERP 专用接口

参数：

{
"suppliers":["YDT"],
"header":["cert_type", "weight", "color", "clarity", "cut", "polish", "symmetry", "fluorescence"],
"rows":[["GIA", "0.3", "I", "SI2", "VG", "EX", "EX", "S"]]
}

返回：

{
"result": true,
"rows": [
{
"cert_type":"GIA",
"weight":"0.3",
"color":"I",
"clarity":"SI2",
"cut":"VG",
"polish":"EX",
"symmetry":"EX",
"fluorescence":"S",
"OriginSN":0,
"CertNo",0,
"Rapnet":0,
"OriginDiscountReturn":0,
"OriginUSDPerCarat":0,
"Supplier":0
}
],
}

POST /api/v2/dpi/costcalculator/dpi-prices2

获取指定货型的最低价

使用 cut_class 匹配

获得指定供应商的一些货型的最低价

ERP 专用接口

参数：

{
"suppliers":["YDT"],
"header":["cert_type", "weight", "color", "clarity", "cut_class", "fluorescence"],
"rows":[["GIA", "0.3", "I", "SI2", "VG", "S"]]
}

返回：

{
"result": true,
"rows": [
{
"cert_type":"GIA",
"weight":"0.3",
"color":"I",
"clarity":"SI2",
"cut_class":"VG",
"cut":"VG",
"polish":"EX",
"symmetry":"EX",
"fluorescence":"S",
"OriginSN":0,
"CertNo",0,
"Rapnet":0,
"OriginDiscountReturn":0,
"OriginUSDPerCarat":0,
"Supplier":0
}
],
}

GET /api/v2/tags

获取货品的标签列表

参数：

  • goods_type 货品类型，可选值(stock|inlay|inlay_setting|parcel|gem)

返回：

["甩卖", "价优"]

GET /api/v2/order3

获取订单列表

goods_type 订单类型：

  • stocks 裸钻

  • inlay-settings 空托

  • inlays 成品

  • parcels 统包

  • gems 彩宝

page_size 分页大小

page_no 当前页

返回：

{
"result": true, // 是否成功
"page_size": 50, // 分页大小
"page_no": 1, // 当前页
"data": [       // 订单列表
{
"status": 0, // 保留字段
"update_time": "2022-02-14 16:42:22", // 订单更新时间
"api_url": "http://hkcgia.com", // ERP系统地址
"order_time": "2022-02-14 16:42:22", // 下单时间
"order_id": "071465d28d7211eca89f00163e029722", // 订单号
"order_items": [ { } ], // 订单明细，具体货品字段含义参考货品查询接口
"supplier": "HKC",      // 供应商
"user": "13800138000",  // 买家
"order_exchange_rate": 6.95, // 下单时汇率
"remarks": "[071465d28d7211eca89f00163e029722] 测试", // 备注
"goods_type": "stocks" // 货品类型
}
]
}

POST /api/v2/order3

下单接口3

此接口将调用货品的供应商对应的ERP系统下单，若没有对应的ERP系统则默认调用HKC系统

提交:

{
"GoodsType": 1, //1裸钻 2统包 3成品 4彩宝 5翡翠 6素金 7空托
"rows": [
{
"ID": 1001,
"InventoryCount": 1 //数量或重量
},
{
"ID": 1002,
"InventoryCount": 1
},
],
"Remarks": "" //备注
}

返回：

{
"result": true, //请求结果
"msg": "", //消息
"data": "" //数据
}

  • 需要token

  • 需要签名

POST /api/v2/order3/batch-delete

删除订单

{"ids": ['order_id1', 'order_id2', '...' ]}

  • ids 为要删除的订单ID数组

由于Android和IOS的HTTP DELETE传递BODY比较麻烦，特此提供此接口

GET /api/v2/settings

获取设置

POST /api/v2/settings

设置

GET /api/v2/kefu/list

客服列表

POST /api/v2/user-delete

删除当前用户账号

  • 需要签名

  • 需要TOKEN

返回：

{
result: true, //请求结果，ture表示成功，false表示失败
msg: '操作成功' //提示信息
}

DELETE /api/v2/user-delete

GET /api/v2/user-permissions

刷新TOKEN

POST /api/v2/refresh-token

GET /api/v2/buyback-sidetype-list

获取回购器副石类型列表

返回：

{
"result": true,
"rows": ["0.01-0.09", "0.03-0.079"]
}

GET /api/v2/buyback-sidetypes

POST /api/v2/buyback-sidetypes

GET /api/v2/buyback-goldtype-list

获取回购器材质列表

返回：

{
"result": true,
"rows": ["AU750", "PT-950"]
}

GET /api/v2/buyback-goldtypes

POST /api/v2/buyback-goldtypes

GET /api/v2/buyback-place-list

获取回购器验收地列表

参数：

  • place //城市过滤

返回：

{
"result": true,
"rows": ["验收地1", "验收地2"]
}

GET /api/v2/buyback-places

获取回购器验收地列表，[管理]

返回：

{
"result": true,
"rows": [

]
}

POST /api/v2/buyback-places

新增回购器验收地

PUT /api/v2/buyback-places

修改回购器验收地

DELETE /api/v2/buyback-places

删除一个回购器验收地

GET /api/v2/buyback-contact-list

获取回购器联系人列表

返回：

{
"result": true,
"rows": [
{
"_id": "客服ID",
"contact_nick": "客服昵称",
"contact_id": "客服微信号",
"avatar": "头像地址"
},
{...}
]
}

POST /api/v2/complaints

举报投诉

{
"user": "13800138000",
"reason": "投诉原因",
}

{
"reault": true,
"msg": "已受理",
}

POST /api/v2/tool-completion

GET /api/v2/notifications

获取当前用户的系统通知

page_size 分页大小

page_no 当前页

返回：

{
"result": true,  // 是否成功
"page_size": 50, // 分页大小
"page_no": 1,    // 当前页
"data": [        // 通知列表
{
'fromUserId': '10000',
'date_time': '2023-6-5-16 20:3:50',
'objectName': 'RC:TxtMsg', //消息类型
'content': '{
"content": "消息内容",
"user": {"icon": "portrait.png", "id": "10000", "name": "系统通知"},
"extra": "relogin"
}',
'toUserId': u'user',
'_id': '647d9ab3e6355b4dd50c1e17'
}
]
}

POST /api/v2/notifications/batch-delete

删除当前用户的系统通知

{"ids": ['id1', 'id2', '...' ]}

  • ids 为要删除的记录的ID数组

由于Android和IOS的HTTP DELETE传递BODY比较麻烦，特此提供此接口

GET /api/v2/user-access-supplier/(.*)

获取用户的数据中心对应的名称

取得用户的数据中心相对应的名称，兼容APP没把supplier设cookie

POST /api/v2/authorizations/

用户登录

接口支持密码模式和验证码模式

  • 需要HTTPS

  • 需要签名

提交参数：

{
"user": "name", // 用户名
"passwd": "password", // 密码，密码模式才需要
"sms_mode": true // 是否验证码模式
"sms_code": "xxx" // 验证码, 验证码模式才需要
}

返回数据：

{
"result": true, // 成功：true，失败：false
"msg": "登录成功！", // 提示信息
"token": "68a6835966514908bd537ed6beb1694f", // 令牌
"mode": 1, // 权限模式
"mode_admin": 0, // 管理员权限模式
"mode_alias": "A", // 权限模式别名
"access": {"supplier": "YDT"}, // 库存授权相关信息，目前只显示授权所绑定的供应商名称，当无相关信息时 access 为 null
"settings": {...},
"cookies": {
"supplier": "YDT",
"mode_alias": "A",
"rate": "7.15",
"token": "68a6835966514908bd537ed6beb1694f",
"rong_token": "rwgi3nrgf3insdfwe",
}
}

POST /api/v2/statistics/

POST /api/v2/push-system-notification-stock-offline/

POST /api/v2/push-system-notification-dpi-suppliers-update/

POST /api/v2/push-system-notification-batch/

GET /api/v2/subscription/

POST /api/v2/subscription/

PUT /api/v2/subscription/

GET /api/v2/subscription/(.*)/

POST /api/v2/subscription/(.*)/

PUT /api/v2/subscription/(.*)/

GET /api/v2/users/(.)/files/(.)

用户文件列表/单个文件

（需要签名、需要令牌、需要管理权限）

接口路径：users/xxx/files/ (xxx: 用户名) 提交方法：GET

返回格式：

{
"result": true, // 成功：true，失败：false
"files": ["abc.jpg", "def.jpg"] // 提示信息
}

用户文件获取

接口路径：users/xxx/files/abc.jpg (xxx: 用户名)

直接返回文件

以下文件需要提供令牌及需要管理员权限： 名片：business_card.jpg 营业执照：business_licenses.jpg 身份证：identity_card.jpg

POST /api/v2/users/(.)/files/(.)

用户文件上传

  • 需要HTTPS

  • 需要签名

  • 需要令牌

  • 特定权限控制

接口路径：users/xxx/files/ (xxx: 用户名)

此接口会根据UUID过滤重复提交，当UUID一样时不会再次执行，只会直接调取上次执行的结果。

本接口支持多文件上传。

提交格式：Query string

提交参数：

users/xxx/files/?filenames=business_card.jpg, business_licenses.jpg&token=xxxx&mode_request_alias=C

  • filenames: 指定文件名，如不指定则为UUID+扩展名

  • token: xxx用户的令牌

  • mode_request_alias: 要求（期望）权限模式

  • subdir: 保存的子目录名称

文件命名：

  • 名片：business_card.jpg

  • 营业执照：business_licenses.jpg

  • 身份证：identity_card.jpg

  • 用户头像：portrait.jpg

权限控制：

  • 用户可以给自己上传文件

  • 管理员可以给所有用户上传文件

返回格式：

{
"result": true, // 成功true，失败false
"msg": "上传成功", // 提示信息
"successes": [
["IMG20160721181443.jpg", "business_card.jpg"],
["IMG_20160718_095748.jpg", "business_licenses.jpg"]
], // 成功的文件名（本地文件名，及对应服务器上的名称）
"failures": [], // 失败的文件名（本地文件名）
"token": "xxxxxxxxxxxxxx",
"token_mode": 3, // 临时令牌权限
"token_mode_alias": "B" // 临时令牌权限别名
}

  • token: 上传时如果指定了mode_request_alias，并且上传内容符合要求，那么将会获得个临时具有mode_request_alias所指定权限模式的令牌（token），有效时间为24小时

GET /api/v2/users/(.*)/files/

用户文件列表/单个文件

（需要签名、需要令牌、需要管理权限）

接口路径：users/xxx/files/ (xxx: 用户名) 提交方法：GET

返回格式：

{
"result": true, // 成功：true，失败：false
"files": ["abc.jpg", "def.jpg"] // 提示信息
}

用户文件获取

接口路径：users/xxx/files/abc.jpg (xxx: 用户名)

直接返回文件

以下文件需要提供令牌及需要管理员权限： 名片：business_card.jpg 营业执照：business_licenses.jpg 身份证：identity_card.jpg

POST /api/v2/users/(.*)/files/

用户文件上传

  • 需要HTTPS

  • 需要签名

  • 需要令牌

  • 特定权限控制

接口路径：users/xxx/files/ (xxx: 用户名)

此接口会根据UUID过滤重复提交，当UUID一样时不会再次执行，只会直接调取上次执行的结果。

本接口支持多文件上传。

提交格式：Query string

提交参数：

users/xxx/files/?filenames=business_card.jpg, business_licenses.jpg&token=xxxx&mode_request_alias=C

  • filenames: 指定文件名，如不指定则为UUID+扩展名

  • token: xxx用户的令牌

  • mode_request_alias: 要求（期望）权限模式

  • subdir: 保存的子目录名称

文件命名：

  • 名片：business_card.jpg

  • 营业执照：business_licenses.jpg

  • 身份证：identity_card.jpg

  • 用户头像：portrait.jpg

权限控制：

  • 用户可以给自己上传文件

  • 管理员可以给所有用户上传文件

返回格式：

{
"result": true, // 成功true，失败false
"msg": "上传成功", // 提示信息
"successes": [
["IMG20160721181443.jpg", "business_card.jpg"],
["IMG_20160718_095748.jpg", "business_licenses.jpg"]
], // 成功的文件名（本地文件名，及对应服务器上的名称）
"failures": [], // 失败的文件名（本地文件名）
"token": "xxxxxxxxxxxxxx",
"token_mode": 3, // 临时令牌权限
"token_mode_alias": "B" // 临时令牌权限别名
}

  • token: 上传时如果指定了mode_request_alias，并且上传内容符合要求，那么将会获得个临时具有mode_request_alias所指定权限模式的令牌（token），有效时间为24小时

GET /api/v2/users/(.*)

用户列表/单个用户

  • 需要签名

  • 需要令牌

  • 特定权限控制

提交格式：Query string

参数说明：

users/?need_audit=1&page_size=50&page=2&list_files=1&sort=mode&desc=1&sort=files_last_upload_time&desc=-1

  • exists_passwd: 是否存在密码

  • mode: 权限模式

  • mode_alias: 权限模式别名。当和mode同时出现，优先级比mode高

  • mode_request: 权限模式

  • mode_request_alias: 权限模式别名。当和mode同时出现，优先级比mode高

  • page_size：每页显示行数，默认50，最大1000

  • page：页码，默认1

  • list_files: 是否显示用户文件，响应时间会有所降低，1为显示，0为不显示，默认0

  • need_audit: 是否需要审核过滤，1为需要，0为不需要

  • sort: 排序，支持多字段排序（不支持排序的：exists_passwd, mode_alias, mode_request_alias, list_files, need_audit)

  • desc: 是否倒序，1为顺序，-1为倒序，出现次数要跟sort一样（要么全指定，要么全部不指定），如不指定默认为1

返回格式：JSON

{
"result": true, // 是否成功
"total": 3, //总页数
"page": 2, //当前页码
"page_size": 50, //每页显示行数
"rows": [
{
"user": "123", //用户名
"nick": "ABC", //称呼，当为null时，说明非用户，禁用聊天功能
"portrait": "http:///static/images/portrait.jpg", //头像
"mode": 1, //权限模式
"mode_alias": "A", //权限模式别名
"mode_request": 3, //请求（期望）的权限模式
"mode_request_alias": "B",
"exists_passwd": true,
"files": ["abc.jpg", "def.jpg"],
"files_last_upload_time": "2016-07-13 18:30:00",
"user_last_update_time": "2016-07-13 18:30:00",
"admin_last_update_time": "2016-07-13 18:30:00",
"mode_last_update_time": "2016-07-13 18:30:00",
"mode_request_last_update_time": "2016-07-13 18:30:00",
"experience" : {
"token" : "8de828ca00534ce0afbbf03de8400b88",
"creation_time" : "2016-07-22 16:01:37",
"token_mode" : 23,
"token_mode_alias" : "C",
"expiration_time" : "2016-07-23 16:01:37"
},
"last_active_uri" : "/api/v1/stocks/filters/",
"last_active_time" : "2016-07-28 17:27:37", //last_active_time: 最后活动时间
"access": { //库存操作的授权信息
"key": "aaaaa",
"secret": "bbbbb",
"supplier": "CCC"
},
"info": {
"Intro": "", //个人介绍
"Company": "", //公司全称
"ShortName": "", //公司简称
"Address": { //地址
"Country": "", //国家
"State": "", //省份（州）
"City": "", //城市
},
"Contact": {
"Name": "", //名字
"Telephone": "", //固定电话1
"Telephone1": "", //固定电话2
"MobilePhone": "", //移动电话1
"MobilePhone1": "", //移动电话2
"QQ": "", //QQ
"Skype": "", //Skype
"WeChat": "", //微信
"Email": "", //电子邮件
"RapID": "", //RAP ID
"Website": "", //网站
"Comment": "", //备注
}
}
"settings": {
"IsDealer": false, //是否经销商
"IsRetailer": false, //是否零售商
"RetailRate": 1.2, //零售价格倍率
"IsPublic": false, //是否公开
"Currency": "CNY", //币种
"ForexRate": 6.8, //外汇率
},
"remarks": { //备注
"Scope": "", //经营范围
"Place": "", //经营地
"Note": "", //注释
},
"statistics": { //统计
"d1": { //1天内
"1": 0, //1对应statistics/接口的code代码
"2": 0,
"3": 0,
...
},
"d30": { //30天内
"1": 0,
"2": 0,
"3": 0,
...
},
},
},
...
]
}

  • mode_requst_alias: 请求（期望）的权限模式别名

  • is_restricted: 是否受限账号，当为true时，该账号登录后只具备 mode_alias = “A” 的权限。

  • exists_passwd: 是否存在密码，未审核的无密码

  • files: 用户文件列表，当查询list_files为1时才会显示该项

  • files_last_upload_time: 文件最后一次上传时间

  • user_last_update_time: 用户最后一次更新时间

  • admin_last_update_time: 管理员最后一次更新时间

  • mode_request_last_update_time: 要求（期望）权限最后一次更新时间

  • mode_last_update_time: 真实权限最后一次更新时间

  • insert_headers: 注册时的HTTP头信息

  • last_login_headers: 最后登陆HTTP头信息

  • experience: 临时体验权限信息（上传名片等资料后取得的）

  • last_active_uri: 最后活动URI

  • last_active_headers: 最后活动HTTP头信息

  • last_active_app: 最后活动APP

  • info: 用户信息，类型及默认值

用户获取

（需要签名、需要令牌、特定权限控制）

接口路径：users/xxx (xxx为用户名)

返回格式：

{
"result": true // 成功：true，失败：false
}

其它参考用户列表接口的字段说明 如果令牌不具备管理员权限，那么将的到有限的字段属性

POST /api/v2/users/(.*)

用户注册

  • 需要HTTPS

  • 需要签名

提交参数：

{
"user": "name", // 用户名
"nick": "Name", // 称呼
"passwd": "abc123", // 密码
"mode_request": 3, // 期望的权限模式
"mode_request_alias": "A", // 期望的权限模式别名
"captcha": "123456" // 验证码
}

  • mode_request 和 mode_request_alias 为二选一，同时存在则优选使用 mode_alias 的值为准。

此接口会根据UUID过滤重复提交，当UUID一样时不会再次执行，只会直接调取上次执行的结果。

返回格式：

{
"result": true, // 成功：true，失败：false
"msg": "用户注册成功！", // 提示信息
"mode": 1, // 权限模式
"mode_alias": "A", // 权限模式别名
"mode_request": 23, // 期望的权限模式
"mode_request_alias": "C", // 期望的权限模式别名
"token": "39dab1a297ce4a59b1244ea4e0ce50ba" // 令牌，注册成功后会自动获取令牌
}

关于权限模式说明：

权限模式的判断使用的是二进位（提交使用十进制），具有权限为1，不具有权限为0。

类别（十进制）

兼容位

可使用证书查询

可使用计算器

可看折扣

可上传库存

可对接数据

可看供应商

可看价格

可看库存

A类（225）

0

1

1

1

0

0

0

0

1

B类（243）

0

1

1

1

1

0

0

1

1

C类（247）

0

1

1

1

1

0

1

1

1

D类（255）

0

1

1

1

1

1

1

1

1

E类（503）

1

1

1

1

1

0

1

1

1

游客（193）

0

1

1

0

0

0

0

0

1

PUT /api/v2/users/(.*)

用户修改

需要HTTPS、需要签名、特定权限控制

接口路径：users/ 或者 users/xxx (xxx为用户名)

此接口会根据UUID过滤重复提交，当UUID一样时不会再次执行，只会直接调取上次执行的结果。

提交参数：

{
"user": "name", // user: 用户名（必填，其它为选填，如果URL路径已经包含，那么这里可以忽略）
"nick": "Name", // nick: 称呼
"mode": 3, // mode: 权限模式
"passwd": "123abc", // passwd: 密码
"is_restricted": true, // is_restricted: 是否受限账号，当为true时，该账号登录后只具备 mode_alias = "A" 的权限。
"token": "asdfsdf"
}

  • mode_alias: 权限模式别名。当和mode同时出现，优先级比mode高

  • mode_request: 要求（期望）权限模式

  • mode_request_alias: 要求（期望）权限模式别名。当和mode_reuqest同时出现，优先级比mode高

  • captcha: 验证码，“重置密码”时需要提供验证码

  • info: 用户的个人信息，注：修改需要info里各属性一起提交，缺少的属性将设置为默认值

权限控制：

重置密码需要的参数（不需要token）： user, captcha, passwd 用户只能改自己的：nick, mode_request, mode_request_alias, passwd, info 其它参数需要token具备管理员权限

返回格式：

{
"result": true, // 成功：true，失败：false
"msg": "用户信息成功更新！" // 提示信息
}

DELETE /api/v2/users/(.*)

用户删除

（需要签名、需要令牌、需要管理权限）

接口路径：users/xxx (xxx为用户名)

此接口会根据UUID过滤重复提交，当UUID一样时不会再次执行，只会直接调取上次执行的结果。

返回格式：

{
"result": true, // 是否成功
"msg": "用户删除成功" //提示信息
}

GET /api/v2/users/

用户列表/单个用户

  • 需要签名

  • 需要令牌

  • 特定权限控制

提交格式：Query string

参数说明：

users/?need_audit=1&page_size=50&page=2&list_files=1&sort=mode&desc=1&sort=files_last_upload_time&desc=-1

  • exists_passwd: 是否存在密码

  • mode: 权限模式

  • mode_alias: 权限模式别名。当和mode同时出现，优先级比mode高

  • mode_request: 权限模式

  • mode_request_alias: 权限模式别名。当和mode同时出现，优先级比mode高

  • page_size：每页显示行数，默认50，最大1000

  • page：页码，默认1

  • list_files: 是否显示用户文件，响应时间会有所降低，1为显示，0为不显示，默认0

  • need_audit: 是否需要审核过滤，1为需要，0为不需要

  • sort: 排序，支持多字段排序（不支持排序的：exists_passwd, mode_alias, mode_request_alias, list_files, need_audit)

  • desc: 是否倒序，1为顺序，-1为倒序，出现次数要跟sort一样（要么全指定，要么全部不指定），如不指定默认为1

返回格式：JSON

{
"result": true, // 是否成功
"total": 3, //总页数
"page": 2, //当前页码
"page_size": 50, //每页显示行数
"rows": [
{
"user": "123", //用户名
"nick": "ABC", //称呼，当为null时，说明非用户，禁用聊天功能
"portrait": "http:///static/images/portrait.jpg", //头像
"mode": 1, //权限模式
"mode_alias": "A", //权限模式别名
"mode_request": 3, //请求（期望）的权限模式
"mode_request_alias": "B",
"exists_passwd": true,
"files": ["abc.jpg", "def.jpg"],
"files_last_upload_time": "2016-07-13 18:30:00",
"user_last_update_time": "2016-07-13 18:30:00",
"admin_last_update_time": "2016-07-13 18:30:00",
"mode_last_update_time": "2016-07-13 18:30:00",
"mode_request_last_update_time": "2016-07-13 18:30:00",
"experience" : {
"token" : "8de828ca00534ce0afbbf03de8400b88",
"creation_time" : "2016-07-22 16:01:37",
"token_mode" : 23,
"token_mode_alias" : "C",
"expiration_time" : "2016-07-23 16:01:37"
},
"last_active_uri" : "/api/v1/stocks/filters/",
"last_active_time" : "2016-07-28 17:27:37", //last_active_time: 最后活动时间
"access": { //库存操作的授权信息
"key": "aaaaa",
"secret": "bbbbb",
"supplier": "CCC"
},
"info": {
"Intro": "", //个人介绍
"Company": "", //公司全称
"ShortName": "", //公司简称
"Address": { //地址
"Country": "", //国家
"State": "", //省份（州）
"City": "", //城市
},
"Contact": {
"Name": "", //名字
"Telephone": "", //固定电话1
"Telephone1": "", //固定电话2
"MobilePhone": "", //移动电话1
"MobilePhone1": "", //移动电话2
"QQ": "", //QQ
"Skype": "", //Skype
"WeChat": "", //微信
"Email": "", //电子邮件
"RapID": "", //RAP ID
"Website": "", //网站
"Comment": "", //备注
}
}
"settings": {
"IsDealer": false, //是否经销商
"IsRetailer": false, //是否零售商
"RetailRate": 1.2, //零售价格倍率
"IsPublic": false, //是否公开
"Currency": "CNY", //币种
"ForexRate": 6.8, //外汇率
},
"remarks": { //备注
"Scope": "", //经营范围
"Place": "", //经营地
"Note": "", //注释
},
"statistics": { //统计
"d1": { //1天内
"1": 0, //1对应statistics/接口的code代码
"2": 0,
"3": 0,
...
},
"d30": { //30天内
"1": 0,
"2": 0,
"3": 0,
...
},
},
},
...
]
}

  • mode_requst_alias: 请求（期望）的权限模式别名

  • is_restricted: 是否受限账号，当为true时，该账号登录后只具备 mode_alias = “A” 的权限。

  • exists_passwd: 是否存在密码，未审核的无密码

  • files: 用户文件列表，当查询list_files为1时才会显示该项

  • files_last_upload_time: 文件最后一次上传时间

  • user_last_update_time: 用户最后一次更新时间

  • admin_last_update_time: 管理员最后一次更新时间

  • mode_request_last_update_time: 要求（期望）权限最后一次更新时间

  • mode_last_update_time: 真实权限最后一次更新时间

  • insert_headers: 注册时的HTTP头信息

  • last_login_headers: 最后登陆HTTP头信息

  • experience: 临时体验权限信息（上传名片等资料后取得的）

  • last_active_uri: 最后活动URI

  • last_active_headers: 最后活动HTTP头信息

  • last_active_app: 最后活动APP

  • info: 用户信息，类型及默认值

用户获取

（需要签名、需要令牌、特定权限控制）

接口路径：users/xxx (xxx为用户名)

返回格式：

{
"result": true // 成功：true，失败：false
}

其它参考用户列表接口的字段说明 如果令牌不具备管理员权限，那么将的到有限的字段属性

POST /api/v2/users/

用户注册

  • 需要HTTPS

  • 需要签名

提交参数：

{
"user": "name", // 用户名
"nick": "Name", // 称呼
"passwd": "abc123", // 密码
"mode_request": 3, // 期望的权限模式
"mode_request_alias": "A", // 期望的权限模式别名
"captcha": "123456" // 验证码
}

  • mode_request 和 mode_request_alias 为二选一，同时存在则优选使用 mode_alias 的值为准。

此接口会根据UUID过滤重复提交，当UUID一样时不会再次执行，只会直接调取上次执行的结果。

返回格式：

{
"result": true, // 成功：true，失败：false
"msg": "用户注册成功！", // 提示信息
"mode": 1, // 权限模式
"mode_alias": "A", // 权限模式别名
"mode_request": 23, // 期望的权限模式
"mode_request_alias": "C", // 期望的权限模式别名
"token": "39dab1a297ce4a59b1244ea4e0ce50ba" // 令牌，注册成功后会自动获取令牌
}

关于权限模式说明：

权限模式的判断使用的是二进位（提交使用十进制），具有权限为1，不具有权限为0。

类别（十进制）

兼容位

可使用证书查询

可使用计算器

可看折扣

可上传库存

可对接数据

可看供应商

可看价格

可看库存

A类（225）

0

1

1

1

0

0

0

0

1

B类（243）

0

1

1

1

1

0

0

1

1

C类（247）

0

1

1

1

1

0

1

1

1

D类（255）

0

1

1

1

1

1

1

1

1

E类（503）

1

1

1

1

1

0

1

1

1

游客（193）

0

1

1

0

0

0

0

0

1

PUT /api/v2/users/

用户修改

需要HTTPS、需要签名、特定权限控制

接口路径：users/ 或者 users/xxx (xxx为用户名)

此接口会根据UUID过滤重复提交，当UUID一样时不会再次执行，只会直接调取上次执行的结果。

提交参数：

{
"user": "name", // user: 用户名（必填，其它为选填，如果URL路径已经包含，那么这里可以忽略）
"nick": "Name", // nick: 称呼
"mode": 3, // mode: 权限模式
"passwd": "123abc", // passwd: 密码
"is_restricted": true, // is_restricted: 是否受限账号，当为true时，该账号登录后只具备 mode_alias = "A" 的权限。
"token": "asdfsdf"
}

  • mode_alias: 权限模式别名。当和mode同时出现，优先级比mode高

  • mode_request: 要求（期望）权限模式

  • mode_request_alias: 要求（期望）权限模式别名。当和mode_reuqest同时出现，优先级比mode高

  • captcha: 验证码，“重置密码”时需要提供验证码

  • info: 用户的个人信息，注：修改需要info里各属性一起提交，缺少的属性将设置为默认值

权限控制：

重置密码需要的参数（不需要token）： user, captcha, passwd 用户只能改自己的：nick, mode_request, mode_request_alias, passwd, info 其它参数需要token具备管理员权限

返回格式：

{
"result": true, // 成功：true，失败：false
"msg": "用户信息成功更新！" // 提示信息
}

DELETE /api/v2/users/

用户删除

（需要签名、需要令牌、需要管理权限）

接口路径：users/xxx (xxx为用户名)

此接口会根据UUID过滤重复提交，当UUID一样时不会再次执行，只会直接调取上次执行的结果。

返回格式：

{
"result": true, // 是否成功
"msg": "用户删除成功" //提示信息
}

GET /api/v2/dealers/

POST /api/v2/dealers/

PUT /api/v2/dealers/

DELETE /api/v2/dealers/

GET /api/v2/dealers/(.*)

POST /api/v2/dealers/(.*)

PUT /api/v2/dealers/(.*)

DELETE /api/v2/dealers/(.*)

GET /api/v2/token/

取得token相关信息

POST /api/v2/stocks/

新增裸钻

PUT /api/v2/stocks/

修改裸钻

DELETE /api/v2/stocks/

删除裸钻

POST /api/v2/stocks/filters/

库存查询

（需要HTTPS，需要签名）

接口路径：stocks/filters/ 提交方法：POST

提交参数：

{
"user": "name", // 用户名
"passwd": "password", // 密码
"inStock": true, // 只搜索现货
}

使用token方式替代user, passwd，因为兼容问题user, passwd依然保留。

其它参数参考：http://dc.checkgems.com/api/v1/

返回格式：

参考：http://dc.checkgems.com/api/v1/

POST /api/v2/dpi/stocks/filters/

库存查询

（需要HTTPS，需要签名）

接口路径：stocks/filters/ 提交方法：POST

提交参数：

{
"user": "name", // 用户名
"passwd": "password", // 密码
"inStock": true, // 只搜索现货
}

使用token方式替代user, passwd，因为兼容问题user, passwd依然保留。

其它参数参考：http://dc.checkgems.com/api/v1/

返回格式：

参考：http://dc.checkgems.com/api/v1/

POST /api/v2/stocks/files/

裸钻货表上传

POST /api/v2/stocks/shelves/

DELETE /api/v2/stocks/shelves/

POST /api/v2/stocks/accesses/

POST /api/v2/stocks/archives/

PUT /api/v2/stocks/batch/

PUT /api/v2/stocks/prices/

POST /api/v2/stocks/(.*)

新增裸钻

PUT /api/v2/stocks/(.*)

修改裸钻

DELETE /api/v2/stocks/(.*)

删除裸钻

GET /api/v2/images/(.*)/

POST /api/v2/images/(.*)/

GET /api/v2/images/(.)/(.)

POST /api/v2/images/(.)/(.)

POST /api/v2/videos/(.*)/

GET /api/v2/parcels/

POST /api/v2/parcels/

PUT /api/v2/parcels/

DELETE /api/v2/parcels/

POST /api/v2/parcels/filters/

POST /api/v2/parcels/files/

GET /api/v2/parcels/(.*)

POST /api/v2/parcels/(.*)

PUT /api/v2/parcels/(.*)

DELETE /api/v2/parcels/(.*)

GET /api/v2/gems/

POST /api/v2/gems/

PUT /api/v2/gems/

DELETE /api/v2/gems/

POST /api/v2/gems/filters/

POST /api/v2/gems/files/

GET /api/v2/gems/(.*)

POST /api/v2/gems/(.*)

PUT /api/v2/gems/(.*)

DELETE /api/v2/gems/(.*)

GET /api/v2/emeralds/

POST /api/v2/emeralds/

PUT /api/v2/emeralds/

DELETE /api/v2/emeralds/

POST /api/v2/emeralds/filters/

POST /api/v2/emeralds/files/

GET /api/v2/emeralds/(.*)

POST /api/v2/emeralds/(.*)

PUT /api/v2/emeralds/(.*)

DELETE /api/v2/emeralds/(.*)

GET /api/v2/inlays/

POST /api/v2/inlays/

PUT /api/v2/inlays/

DELETE /api/v2/inlays/

POST /api/v2/inlays/filters/

POST /api/v2/inlays/files/

GET /api/v2/(inlays)/same-style/(.*)

GET /api/v2/inlays/(.*)

POST /api/v2/inlays/(.*)

PUT /api/v2/inlays/(.*)

DELETE /api/v2/inlays/(.*)

GET /api/v2/inlay-settings/

POST /api/v2/inlay-settings/

PUT /api/v2/inlay-settings/

DELETE /api/v2/inlay-settings/

POST /api/v2/inlay-settings/filters/

POST /api/v2/inlay-settings/files/

GET /api/v2/(inlay-settings)/same-style/(.*)

GET /api/v2/inlay-settings/(.*)

POST /api/v2/inlay-settings/(.*)

PUT /api/v2/inlay-settings/(.*)

DELETE /api/v2/inlay-settings/(.*)

GET /api/v2/prime-golds/

POST /api/v2/prime-golds/

PUT /api/v2/prime-golds/

DELETE /api/v2/prime-golds/

POST /api/v2/prime-golds/filters/

POST /api/v2/prime-golds/files/

PUT /api/v2/prime-golds/batch/

GET /api/v2/prime-golds/price/

PUT /api/v2/prime-golds/price/

GET /api/v2/prime-golds/(.*)

POST /api/v2/prime-golds/(.*)

PUT /api/v2/prime-golds/(.*)

DELETE /api/v2/prime-golds/(.*)

GET /api/v2/certs/(aigs|AIGS|grs|GRS)/

GET /api/v2/certs/(.)/(.).pdf

GET /api/v2/certs/(.)/(.).jpg

获取证书JPG

证书JPG

接口路径：certs/XXX/YYYYYY.jpg 提交方法：GET 返回格式：直接302跳转到JPG 返回格式：

直接302跳转到JPG文件

提交格式及参数说明：

certs/GIA/12345678.JPG

GET /api/v2/spider/certs/(gia|GIA|igi|IGI)/(\w+).pdf

获取证书PDF

证书PDF（需要签名、需要令牌）

接口路径：certs/XXX/YYYYYY.pdf 提交方法：GET 返回格式：直接302跳转到PDF 返回格式：

直接302跳转到PDF文件

提交格式及参数说明：

certs/GIA/12345678.pdf

DELETE /api/v2/spider/certs/(gia|GIA|igi|IGI)/(\w+).pdf

GET /api/v2/spider/certs/(.)/(.).jpg

获取证书JPG

证书JPG

接口路径：certs/XXX/YYYYYY.jpg 提交方法：GET 返回格式：直接302跳转到JPG 返回格式：

直接302跳转到JPG文件

提交格式及参数说明：

certs/GIA/12345678.JPG

GET /api/v2/spider/certs/(gia|GIA|igi|IGI)/(\w+)

获取证书信息

GET /api/v2/certs-cache/(gia|GIA)/(\w+)

POST /api/v2/certs-cache/(gia|GIA)/(\w+)

GET /api/v2/certs/(.)/(.)

证书查询

接口路径：certs/XXX/YYYYYY 提交方法：GET

返回：

{
"result": true,
...
}

  • result: 成功: true 失败: false

  • data: 官网数据

  • is_pdf_available: PDF是否可用

提交格式及参数说明

certs/GIA/123456

POST /api/v2/captchas/sms/

验证码短信发送

  • 需要签名

此接口会根据UUID过滤重复提交，当UUID一样时不会再次执行，只会直接调取上次执行的结果。

提交：

{
"phone_num": "13000000000", //手机号码
"is_reset_passwd": false //是否为“重置密码”验证码短信
}

国际号码需包含国际地区前缀号码，格式必须是”+”号开头(E.164标准)，国际号码不以”+”开头将被认为是中国地区的号码

返回：

{
"result": true, //是否成功
"msg": "短信发送成功！" //消息
}

GET /api/v2/suppliers/(.*)

POST /api/v2/suppliers/(.*)

PUT /api/v2/suppliers/(.*)

GET /api/v2/suppliers/

POST /api/v2/suppliers/

PUT /api/v2/suppliers/

GET /api/v2/suppliers-dc/

GET /api/v2/suppliers-attribute/

PUT /api/v2/suppliers-attribute/

POST /api/v2/calculator/

GET /api/v2/docs/yjg

GET /api/v2/docs/nwc

GET /api/v2/checkgems-admin/users-permissions

PUT /api/v2/checkgems-admin/users-permissions

POST /api/v2/checkgems-admin/check-user-permission

GET /api/v2/checkgems-admin/user-nav

POST /api/v2/checkgems-admin/user-nav

GET /api/v2/checkgems-admin/user-display

POST /api/v2/checkgems-admin/user-display

GET /api/v2/issues

POST /api/v2/issues

PUT /api/v2/issues

DELETE /api/v2/issues

GET /api/v2/issues/(\w{24})

POST /api/v2/issues/(\w{24})

PUT /api/v2/issues/(\w{24})

DELETE /api/v2/issues/(\w{24})

POST /api/v2/issues/images

POST /api/v2/issues/images/(.*)

GET /api/v2/issues/comment

POST /api/v2/issues/comment

PUT /api/v2/issues/comment

DELETE /api/v2/issues/comment

GET /api/v2/issues/(\w{24})/comment

POST /api/v2/issues/(\w{24})/comment

PUT /api/v2/issues/(\w{24})/comment

DELETE /api/v2/issues/(\w{24})/comment

GET /api/v2/issues/public

POST /api/v2/issues/public

PUT /api/v2/issues/public

DELETE /api/v2/issues/public

GET /api/v2/issues/(\w{24})/public

POST /api/v2/issues/(\w{24})/public

PUT /api/v2/issues/(\w{24})/public

DELETE /api/v2/issues/(\w{24})/public

GET /api/v2/issues/likes

POST /api/v2/issues/likes

PUT /api/v2/issues/likes

DELETE /api/v2/issues/likes

GET /api/v2/issues/(\w{24})/likes

POST /api/v2/issues/(\w{24})/likes

PUT /api/v2/issues/(\w{24})/likes

DELETE /api/v2/issues/(\w{24})/likes

GET /api/v2/faqs

POST /api/v2/faqs

PUT /api/v2/faqs

DELETE /api/v2/faqs

GET /api/v2/faqs/(\w{24})

POST /api/v2/faqs/(\w{24})

PUT /api/v2/faqs/(\w{24})

DELETE /api/v2/faqs/(\w{24})

POST /api/v2/faqs/images

POST /api/v2/faqs/images/(.*)

GET /api/v2/notices

POST /api/v2/notices

PUT /api/v2/notices

DELETE /api/v2/notices

GET /api/v2/notices/(\w{24})

POST /api/v2/notices/(\w{24})

PUT /api/v2/notices/(\w{24})

DELETE /api/v2/notices/(\w{24})

POST /api/v2/notices/images

POST /api/v2/notices/images/(.*)

GET /api/v2/ads

POST /api/v2/ads

PUT /api/v2/ads

DELETE /api/v2/ads

GET /api/v2/ads/(\w{24})

POST /api/v2/ads/(\w{24})

PUT /api/v2/ads/(\w{24})

DELETE /api/v2/ads/(\w{24})

GET /api/v2/ads/images

POST /api/v2/ads/images

GET /api/v2/ads/images/(.*)

POST /api/v2/ads/images/(.*)

GET /api/v2/help/chat/

GET /api/v2/contacts/friends/

POST /api/v2/contacts/friends/

PUT /api/v2/contacts/friends/

DELETE /api/v2/contacts/friends/

GET /api/v2/contacts/friends/(.*)

POST /api/v2/contacts/friends/(.*)

PUT /api/v2/contacts/friends/(.*)

DELETE /api/v2/contacts/friends/(.*)

GET /api/v2/contacts/new-friends/

POST /api/v2/contacts/new-friends/

DELETE /api/v2/contacts/new-friends/

GET /api/v2/contacts/new-friends/(.*)

POST /api/v2/contacts/new-friends/(.*)

DELETE /api/v2/contacts/new-friends/(.*)

GET /api/v2/contacts/tags/([^/]*)/?

POST /api/v2/contacts/tags/([^/]*)/?

PUT /api/v2/contacts/tags/([^/]*)/?

DELETE /api/v2/contacts/tags/([^/]*)/?

GET /api/v2/contacts/blacklists/

POST /api/v2/contacts/blacklists/

DELETE /api/v2/contacts/blacklists/

GET /api/v2/contacts/blacklists/(.*)

POST /api/v2/contacts/blacklists/(.*)

DELETE /api/v2/contacts/blacklists/(.*)

GET /api/v2/contacts/groups/([^/]*)/?

POST /api/v2/contacts/groups/([^/]*)/?

PUT /api/v2/contacts/groups/([^/]*)/?

DELETE /api/v2/contacts/groups/([^/]*)/?

GET /api/v2/contacts/member-list/

GET /api/v2/contacts/phone-attion/

GET /api/v2/translate/

GET /api/v2/moment/images

POST /api/v2/moment/images

GET /api/v2/moment/images/(.*)

POST /api/v2/moment/images/(.*)

GET /api/v2/moment

POST /api/v2/moment

DELETE /api/v2/moment

GET /api/v2/moment/(\w{24})

POST /api/v2/moment/(\w{24})

DELETE /api/v2/moment/(\w{24})

GET /api/v2/moment/album

GET /api/v2/moment/album/(.*)

GET /api/v2/moment/albumentry

GET /api/v2/moment/albumentry/(.*)

GET /api/v2/moment/dynamic

GET /api/v2/moment/subscribed

POST /api/v2/moment/comments

DELETE /api/v2/moment/comments

POST /api/v2/moment/(\w{24})/comments

DELETE /api/v2/moment/(\w{24})/comments

PUT /api/v2/moment/likes

PUT /api/v2/moment/(\w{24})/likes

GET /api/v2/moment/notifications/entry

GET /api/v2/moment/notifications

PUT /api/v2/moment/notifications

DELETE /api/v2/moment/notifications

GET /api/v2/moment/users/vip/quantity-remain

GET /api/v2/moment/users/not-shown

POST /api/v2/moment/users/not-shown

DELETE /api/v2/moment/users/not-shown

GET /api/v2/moment/users/not-allowed

POST /api/v2/moment/users/not-allowed

DELETE /api/v2/moment/users/not-allowed

PUT /api/v2/moment/users/settings

GET /api/v2/friendships

GET /api/v2/friendships/followers

DELETE /api/v2/friendships/followers

GET /api/v2/friendships/following

POST /api/v2/friendships/following

DELETE /api/v2/friendships/following

GET /api/v2/categories

查询分类

支持多语言存储 前台页面自动根据语言代码获取对应语言内容，管理后台可获取全部语言内容 可自行决定是否返回整棵树，或者是返回当前与下一级目录详情，可供异步加载使用 根目录root不参与查询，管理后台加admin参数即可默认取得root和一级子级然后按oid查询子级即可，或直接取得整棵树 管理后台返回全部is_available类型，前台页面默认只会返回is_available=true 无论前台页面与后台管理，均不会返回is_deleted=true的记录，也不会在父级的children中出现，它将在后台管理的回收站功能中使用

查询它的父级：它的直接父级，它的全部父级路径（面包屑导航） :return:

POST /api/v2/categories

新增分类

需提供父级ID与分类内容 一个分类有且仅有一个父级。 一级目录必须有code，其它子级为可选，默认会是空 code全局唯一，不能重复 如果不传is_available，默认为可用true

:return:

PUT /api/v2/categories

修改分类

修改内容 修改code，根目录code不允许修改 修改所属父级，即移动分类，depth值会递归自动重新计算 修改子级的排序 :return:

DELETE /api/v2/categories

删除分类

分有逻辑删除与彻底删除，请提供absolutely参数自行决定 操作删除一个分类，有两个情况：仅仅删除这个分类，子分类自动提升级别；删除这个分类和它的全部子分类。 当然如果它没有子分类，就自然是无需考虑上述两种情况。

:return:

GET /api/v2/categories/available

GET /api/v2/categories/recycle

GET /api/v2/categories/search

GET /api/v2/news

POST /api/v2/news

PUT /api/v2/news

DELETE /api/v2/news

GET /api/v2/news/(\w{24})

POST /api/v2/news/(\w{24})

PUT /api/v2/news/(\w{24})

DELETE /api/v2/news/(\w{24})

GET /api/v2/news/published

GET /api/v2/news/published/(\w{24})

POST /api/v2/news/comments

DELETE /api/v2/news/comments

POST /api/v2/news/(\w{24})/comments

DELETE /api/v2/news/(\w{24})/comments

GET /api/v2/news/images

POST /api/v2/news/images

GET /api/v2/news/images/(.*)

POST /api/v2/news/images/(.*)

GET /api/v2/ueditor

POST /api/v2/ueditor

GET /api/v2/yzueditor

GET /api/v2/umeditor

GET /api/v2/dpi/pointer/(.*)

GET /api/v2/dpi/pointer

GET /api/v2/dpi/prices

GET /api/v2/dpi/prices2

GET /api/v2/dpi/trends

GET /api/v2/dpi/products

POST /api/v2/dpi/costcalculator/by-grain

POST /api/v2/dpi/costcalculator/by-return

POST /api/v2/dpi/costcalculator/prices-adjuster

GET /api/v2/dpi/costcalculator/stock-prices-adjuster

POST /api/v2/dpi/costcalculator/stock-prices-adjuster

POST /api/v2/dpi/costcalculator/download

GET /api/v2/dpi/productsfilters

POST /api/v2/dpi/productsfilters

PUT /api/v2/dpi/productsfilters

DELETE /api/v2/dpi/productsfilters

GET /api/v2/dpi/productsfilters/(\w{24})

POST /api/v2/dpi/productsfilters/(\w{24})

PUT /api/v2/dpi/productsfilters/(\w{24})

DELETE /api/v2/dpi/productsfilters/(\w{24})

GET /api/v2/dpi/productsfilters/groups

POST /api/v2/dpi/productsfilters/groups

PUT /api/v2/dpi/productsfilters/groups

DELETE /api/v2/dpi/productsfilters/groups

GET /api/v2/dpi/productsfilters/groups/(\w{24})

POST /api/v2/dpi/productsfilters/groups/(\w{24})

PUT /api/v2/dpi/productsfilters/groups/(\w{24})

DELETE /api/v2/dpi/productsfilters/groups/(\w{24})

POST /api/v2/dpi/productsfilters/upload

GET /api/v2/dpi/suppliers-stocks-update/

GET /api/v2/dc-access/settings/blacklist/(.*)

PUT /api/v2/dc-access/settings/blacklist/(.*)

GET /api/v2/dc-access/settings/blacklist/

PUT /api/v2/dc-access/settings/blacklist/

GET /api/v2/assistants/search

GET /api/v2/assistants/categories

POST /api/v2/assistants/categories

PUT /api/v2/assistants/categories

DELETE /api/v2/assistants/categories

GET /api/v2/assistants/join

GET /api/v2/assistants

GET /api/v2/cgstatistics/parameters

GET /api/v2/cgstatistics/realtime

GET /api/v2/cgstatistics/polymerpv

GET /api/v2/cgstatistics/polymeruv

GET /api/v2/cgstatistics/users

GET /api/v2/cgstatistics/user-pv

GET /api/v2/checkgems-item/

POST /api/v2/checkgems-item/

PUT /api/v2/checkgems-item/

DELETE /api/v2/checkgems-item/

POST /api/v2/checkgems-item/images/

GET /api/v2/checkgems-item/authority/

POST /api/v2/checkgems-item/authority/

PUT /api/v2/checkgems-item/authority/

DELETE /api/v2/checkgems-item/authority/

GET /api/v2/checkgems-item/bug/

POST /api/v2/checkgems-item/bug/

PUT /api/v2/checkgems-item/bug/

GET /api/v2/checkgems-item/ueditor/

POST /api/v2/checkgems-item/ueditor/

GET /api/v2/checkgems-item/authority/(.*)

POST /api/v2/checkgems-item/authority/(.*)

PUT /api/v2/checkgems-item/authority/(.*)

DELETE /api/v2/checkgems-item/authority/(.*)

GET /api/v2/checkgems-item/bug/(.*)

POST /api/v2/checkgems-item/bug/(.*)

PUT /api/v2/checkgems-item/bug/(.*)

GET /api/v2/checkgems-item/(.*)

POST /api/v2/checkgems-item/(.*)

PUT /api/v2/checkgems-item/(.*)

DELETE /api/v2/checkgems-item/(.*)

GET /api/v2/diamondsales/polymer

GET /api/v2/diamond-data/qty

GET /api/v2/purchase-intentions/groups/(\w{24})

POST /api/v2/purchase-intentions/groups/(\w{24})

PUT /api/v2/purchase-intentions/groups/(\w{24})

DELETE /api/v2/purchase-intentions/groups/(\w{24})

GET /api/v2/purchase-intentions/groups

POST /api/v2/purchase-intentions/groups

PUT /api/v2/purchase-intentions/groups

DELETE /api/v2/purchase-intentions/groups

GET /api/v2/purchase-intentions/contacts/(\w{24})

POST /api/v2/purchase-intentions/contacts/(\w{24})

PUT /api/v2/purchase-intentions/contacts/(\w{24})

DELETE /api/v2/purchase-intentions/contacts/(\w{24})

GET /api/v2/purchase-intentions/contacts

POST /api/v2/purchase-intentions/contacts

PUT /api/v2/purchase-intentions/contacts

DELETE /api/v2/purchase-intentions/contacts

GET /api/v2/purchase-intentions/notices/(\w{24})

POST /api/v2/purchase-intentions/notices/(\w{24})

PUT /api/v2/purchase-intentions/notices/(\w{24})

DELETE /api/v2/purchase-intentions/notices/(\w{24})

GET /api/v2/purchase-intentions/notices

POST /api/v2/purchase-intentions/notices

PUT /api/v2/purchase-intentions/notices

DELETE /api/v2/purchase-intentions/notices

GET /api/v2/purchase-intentions/(\w{24})

POST /api/v2/purchase-intentions/(\w{24})

PUT /api/v2/purchase-intentions/(\w{24})

修改需求退点等属性

参数：

{
"rows": [
{
"oid": "xxxxxxxxxxxxxxxxxxxxxxxx",
"discount_return": "-31.5"
}
]
}

返回：

{
"msg": "修改成功", //提示信息
"result": true //成功true，失败false
}

DELETE /api/v2/purchase-intentions/(\w{24})

GET /api/v2/purchase-intentions

POST /api/v2/purchase-intentions

PUT /api/v2/purchase-intentions

修改需求退点等属性

参数：

{
"rows": [
{
"oid": "xxxxxxxxxxxxxxxxxxxxxxxx",
"discount_return": "-31.5"
}
]
}

返回：

{
"msg": "修改成功", //提示信息
"result": true //成功true，失败false
}

DELETE /api/v2/purchase-intentions

GET /api/v2/purchase-intentions/available

GET /api/v2/purchase-intentions/contacts/available

GET /api/v2/purchase-intentions/notices/available

POST /api/v2/purchase-intentions/match

GET /api/v2/purchase-intentions/blacklist

POST /api/v2/purchase-intentions/blacklist

DELETE /api/v2/purchase-intentions/blacklist

GET /api/v2/diamonds-buyback/exchange-rate

PUT /api/v2/diamonds-buyback/exchange-rate

GET /api/v2/diamonds-buyback/contacts/available

获取回购器客服列表

返回：

{
"result": true,
"row": {
"Wechat": [
{
"contact_nick": "查宝",
"contact_method": "Wechat",
"contact_id": "18823822382",
"sort_order": 2,
"is_available": true,
"avatar": "",
"contact_name": "客服",
"_id": "5a6693f6b691e43d266554f6",
"created_at": "2018-01-23 09:46:30"
}
]
}
}

GET /api/v2/diamonds-buyback/contacts/(\w{24})

POST /api/v2/diamonds-buyback/contacts/(\w{24})

PUT /api/v2/diamonds-buyback/contacts/(\w{24})

DELETE /api/v2/diamonds-buyback/contacts/(\w{24})

GET /api/v2/diamonds-buyback/contacts

POST /api/v2/diamonds-buyback/contacts

PUT /api/v2/diamonds-buyback/contacts

DELETE /api/v2/diamonds-buyback/contacts

GET /api/v2/diamonds-buyback/valuation/gold

GET /api/v2/diamonds-buyback/valuation/secondary

GET /api/v2/diamonds-buyback/valuation/erp

估值计算

提交参数说明：

  • shape: 形状

  • weight: 重量

  • color: 颜色

  • clarity: 净度

  • cut: 切工

  • polish: 抛光

  • symmetry: 对称

  • fluorescence: 荧光

  • cert_type: 证书类型

  • laser_code: 字印

  • new_certificate: 证书年份

  • side_weight: 副石重

  • side_type: 副石类型

  • gold_weight: 金重

  • gold_type: 材质

返回JSON：

{
"result": true,            //是否成功
"row": {
"exchange_rate": 7.15, //汇率
"valuation": 3000,     //最低
"valuation_max": 3500  //最高
}
}

GET /api/v2/diamonds-buyback/valuation

估值计算

提交参数说明：

  • shape: 形状

  • weight: 重量

  • color: 颜色

  • clarity: 净度

  • cut: 切工

  • polish: 抛光

  • symmetry: 对称

  • fluorescence: 荧光

  • cert_type: 证书类型

  • laser_code: 字印

  • new_certificate: 证书年份

  • side_weight: 副石重

  • side_type: 副石类型

  • gold_weight: 金重

  • gold_type: 材质

返回JSON：

{
"result": true,            //是否成功
"row": {
"exchange_rate": 7.15, //汇率
"valuation": 3000,     //最低
"valuation_max": 3500  //最高
}
}

GET /api/v2/diamonds-buyback/weight-convert/(\w{24})

PUT /api/v2/diamonds-buyback/weight-convert/(\w{24})

GET /api/v2/diamonds-buyback/weight-convert

PUT /api/v2/diamonds-buyback/weight-convert

GET /api/v2/diamonds-buyback/others-convert/(\w{24})

PUT /api/v2/diamonds-buyback/others-convert/(\w{24})

GET /api/v2/diamonds-buyback/others-convert

PUT /api/v2/diamonds-buyback/others-convert

GET /api/v2/diamonds-buyback/(\w{24})

PUT /api/v2/diamonds-buyback/(\w{24})

GET /api/v2/diamonds-buyback

PUT /api/v2/diamonds-buyback

GET /api/v2/special-products/(\w{24})

POST /api/v2/special-products/(\w{24})

PUT /api/v2/special-products/(\w{24})

DELETE /api/v2/special-products/(\w{24})

GET /api/v2/special-products

POST /api/v2/special-products

PUT /api/v2/special-products

DELETE /api/v2/special-products

GET /api/v2/special-products/available/(\w{24})

GET /api/v2/special-products/available

GET /api/v2/special-products/manage/(\w{24})

PUT /api/v2/special-products/manage/(\w{24})

DELETE /api/v2/special-products/manage/(\w{24})

GET /api/v2/special-products/manage

PUT /api/v2/special-products/manage

DELETE /api/v2/special-products/manage

GET /api/v2/special-products/contacts/(\w{24})

POST /api/v2/special-products/contacts/(\w{24})

PUT /api/v2/special-products/contacts/(\w{24})

DELETE /api/v2/special-products/contacts/(\w{24})

GET /api/v2/special-products/contacts

POST /api/v2/special-products/contacts

PUT /api/v2/special-products/contacts

DELETE /api/v2/special-products/contacts

GET /api/v2/special-products/contacts/available

GET /api/v2/stocks-reports/assessments/groups/(\w{24})

POST /api/v2/stocks-reports/assessments/groups/(\w{24})

PUT /api/v2/stocks-reports/assessments/groups/(\w{24})

DELETE /api/v2/stocks-reports/assessments/groups/(\w{24})

GET /api/v2/stocks-reports/assessments/groups

POST /api/v2/stocks-reports/assessments/groups

PUT /api/v2/stocks-reports/assessments/groups

DELETE /api/v2/stocks-reports/assessments/groups

GET /api/v2/stocks-reports/assessments/(\w{24})

POST /api/v2/stocks-reports/assessments/(\w{24})

PUT /api/v2/stocks-reports/assessments/(\w{24})

DELETE /api/v2/stocks-reports/assessments/(\w{24})

GET /api/v2/stocks-reports/assessments

POST /api/v2/stocks-reports/assessments

PUT /api/v2/stocks-reports/assessments

DELETE /api/v2/stocks-reports/assessments

POST /api/v2/stocks-reports/download

ERP的库存报告

GET /api/v2/stocks-reports/stock

POST /api/v2/stocks-reports/stock

GET /api/v2/stocks-reports

POST /api/v2/stocks-reports

GET /api/v2/stock-subscribe/assessments

GET /api/v2/stock-subscribe/assessments/(\w{24})

GET /api/v2/stock-subscribe/suppliers

PUT /api/v2/stock-subscribe/suppliers

GET /api/v2/stock-subscribe/wishlist

POST /api/v2/stock-subscribe/wishlist

PUT /api/v2/stock-subscribe/wishlist

DELETE /api/v2/stock-subscribe/wishlist

GET /api/v2/stock-subscribe/wishlist/(\w{24})

POST /api/v2/stock-subscribe/wishlist/(\w{24})

PUT /api/v2/stock-subscribe/wishlist/(\w{24})

DELETE /api/v2/stock-subscribe/wishlist/(\w{24})

POST /api/v2/stock-subscribe/stock-push

POST /api/v2/special-auction/bidding/(\w{24})

POST /api/v2/special-auction/bidding

POST /api/v2/special-auction/notification/(\w{24})

POST /api/v2/special-auction/notification

GET /api/v2/special-auction/available/(\w{24})

GET /api/v2/special-auction/available

GET /api/v2/special-auction/manage/(\w{24})

PUT /api/v2/special-auction/manage/(\w{24})

DELETE /api/v2/special-auction/manage/(\w{24})

GET /api/v2/special-auction/manage

PUT /api/v2/special-auction/manage

DELETE /api/v2/special-auction/manage

GET /api/v2/special-auction/(\w{24})

POST /api/v2/special-auction/(\w{24})

PUT /api/v2/special-auction/(\w{24})

DELETE /api/v2/special-auction/(\w{24})

GET /api/v2/special-auction

POST /api/v2/special-auction

PUT /api/v2/special-auction

DELETE /api/v2/special-auction

GET /api/v2/announcements/apphome/(\w{24})

POST /api/v2/announcements/apphome/(\w{24})

GET /api/v2/announcements/apphome

POST /api/v2/announcements/apphome

GET /api/v2/announcements/(\w{24})

POST /api/v2/announcements/(\w{24})

PUT /api/v2/announcements/(\w{24})

DELETE /api/v2/announcements/(\w{24})

GET /api/v2/announcements

POST /api/v2/announcements

PUT /api/v2/announcements

DELETE /api/v2/announcements

PUT /api/v2/cgusers

PUT /api/v2/cgusers/(.*)

GET /api/v2/sts

GET /api/v2/sts/(.*)

GET /api/v2/oss/products

GET /api/v2/oss/products/(.*)

POST /api/v2/oss/callback-server/certs

POST /api/v2/oss/callback-server/moments

POST /api/v2/oss/callback-server/diamonds

POST /api/v2/oss/callback-server/special-products

GET /api/v2/oss/certs/media/

POST /api/v2/pub-system-message-batch-by-pushtags/product-push

POST /api/v2/order/

PUT /api/v2/order/

GET /api/v2/order/backstage-list/(.*)

GET /api/v2/order/statuscount/(.*)

GET /api/v2/order/shopcart/

POST /api/v2/order/shopcart/

DELETE /api/v2/order/shopcart/

GET /api/v2/order/address/(.*)

POST /api/v2/order/address/(.*)

PUT /api/v2/order/address/(.*)

DELETE /api/v2/order/address/(.*)

POST /api/v2/order/confirm_order/

GET /api/v2/order/(.*)

POST /api/v2/pay-order/vip/

GET /api/v2/pay-order/mode-experience/

POST /api/v2/pay-order/mode-experience/

POST /api/v2/pay-order/transfer/

POST /api/v2/pay-order/wxpay/notify/

GET /api/v2/payment/record/

POST /api/v2/payment/record/

收款记录

  • status: 1待审核 2已审核

  • trade_type: 1VIP会员 2临时体验权限 3特品拍卖 4提现

PUT /api/v2/payment/record/

GET /api/v2/payment/account/

POST /api/v2/payment/withdrawals/

PUT /api/v2/payment/withdrawals/

POST /api/v2/order2

下单接口2

此接口下单到ERP系统88gia

提交：

{
"GoodsType": 1, //1裸钻 2统包 3成品 4彩宝 5翡翠 6素金 7空托
"rows": [
{
"ID": 1001,
"InventoryCount": 1 //数量或重量
},
{
"ID": 1002,
"InventoryCount": 1
},
],
"Remarks": "" //附言
}

返回：

{
"result": true, //请求结果
"msg": "", //消息
"data": "" //数据
}

注意：

  • 需要token

  • 需要签名

GET /api/v2/cg-price/([\w-]+)/(.*)

PUT /api/v2/cg-price/([\w-]+)/(.*)

GET /api/v2/integral/event/manager/

POST /api/v2/integral/event/manager/

PUT /api/v2/integral/event/manager/

DELETE /api/v2/integral/event/manager/

GET /api/v2/integral/event/manager/qrcode/(.*)

GET /api/v2/integral/event/manager/(.*)

POST /api/v2/integral/event/manager/(.*)

PUT /api/v2/integral/event/manager/(.*)

DELETE /api/v2/integral/event/manager/(.*)

GET /api/v2/integral/event/(.*)

POST /api/v2/integral/event/(.*)

GET /api/v2/integral/access/

GET /api/v2/product-filter/groups

获得所有参数分组

POST /api/v2/product-filter/groups

创建参数分组

PUT /api/v2/product-filter/groups

修改参数分组

DELETE /api/v2/product-filter/groups

删除参数分组

GET /api/v2/product-filter/filters

获得一个分组所有过滤参数

POST /api/v2/product-filter/filters

新增过滤参数

PUT /api/v2/product-filter/filters

修改参数

DELETE /api/v2/product-filter/filters

删除参数

POST /api/v2/media-infos

查询图片视频信息

根据uid查询MediaID等信息

GET /api/v2/cert-urls/(\w+)/(\w+)

查询证书图

根据证书类型和证书号查询证书图

GET /api/v2/cert-info/(\w+)/(\w+)

查询证书文字信息

根据证书类型和证书号查询证书文字信息

GET /api/v2/chat/new-message-exist/(.+)

检测当前用户是否有聊天消息

POST /api/v2/rap-upload/

上传当前用户库存到RAP