3D编辑器 SDK + API

所有 API 请求均为 REST 式样 URL 标准 HTTP 请求。 回应是 JSON 或图像(在提取结果时)。

身份验证

API 使用标准的 HTTP 基本存取身份验证( 请求header 中加入token ) 所有 API 请求将需要包括您的 token 凭据,token可以根据需要进行轮换,变换后旧的token会马上失效

示例中的token是演示值,其状态会不定时变换,不要用在生产活动中

您可以随时在您的个人中心上找到自己的 API 凭证和使用信息。

后端与前端

接口不限制你在后端和前端使用,为了安全起见最佳是在后端调用我们的接口

速率及特效限制

在正常使用过程中,由于该服务一般可轻松应对使用的起伏,您不大可能会遇到任何速率限制。

请求过大可能出现返回结果慢的情况,这个无需担心,我们的服务器采用消息队列模式,会按照队列以此进行生产

psd 生成图片和生成文件的大小(像素值),分辨率(现阶段分辨率最高支持100分辨率), 智能图层的大小和带替换图层的数量都有密切的关系,我们会提供一个【示例PSD】,您可以以此作为制作范版 从而达到生成图片的最佳效果,

我们不是无限的还原ps的全部,请根据我们的 【示例PSD】 进行制作,此包含的全部功能都能完美实现, 如有其他的ps功能需求,可以联系我们,我们进行专门的评估开发

编辑器 SDK前端引入SDK

1、引入 CDN下载地址

<script src="https://img.foxpsd.com/foxpsd-1.0.0.js"></script>

js 文件已启用CDN托管,可直接引用

<script src="https://img.foxpsd.com/foxpsd3DEdit.umd.js"></script>

js 文件已启用CDN托管,可直接引用

<link rel="stylesheet" type="text/css" href="https://img.foxpsd.com/foxpsd3DEdit.css" />

css 文件已启用CDN托管,可直接引用

点击查看演示

演示中的token,不定期轮换,请勿用于生产环境中

2、 实例化方法 new foxpsd3DEdit.main(element,options)

属性及方法

element
字符串
必传
dom id
options.token
字符串
[此处为浏览器token]
必传
验证身份用的 token 在个人中心/浏览器token查看
options.goodsSku
字符串
必传
订单的产品 sku 在 个人中心/API 计数查看
options.title
字符串
非必传
左上角logo位置,可设置 html标签来实现特殊需求
options.callBackHref
字符串
非必传
效果图及尺码图生成完成后的回调地址,foxpsd会把生成的sku拼接上后发送GET来请求此地址,开发者可通过 /api/diy/userSave/item 来获取详细数据
options.saveCallback
字符串
非必传
模板点击保存之后的回调方法,会返回保存后的 sku,开发者可自行存储,来实现后面逻辑

请求演示

  1. <link rel="stylesheet" type="text/css" href="https://img.foxpsd.com/foxpsd3DEdit.css" />
  2. <script src="https://img.foxpsd.com/foxpsd-1.0.0.js"></script>
  3. <script src="https://img.foxpsd.com/foxpsd3DEdit.umd.js"></script>
  4. new foxpsd3DEdit.main('#app',{
  5. token:'Basic xxxxxxxxxxxxxxxxxxxx',
  6. goodsSku:'1645061099030970357(演示值,请查看文档获取)',
  7. userSku:'511536b8-2f26-4a9a-b87f-3c55271da733(演示值,请查看文档获取)',
  8. title:`logo 或标题`,
  9. // 数据图片生成完成后的回调地址,方式为GET请求
  10. callBackHref:"http://xxxxxxxx",
  11. // 设置保存完成的跳转链接
  12. saveCallback:function(res){
  13. console.log('保存完成',res);
  14. //保存完成,会返回当前的保存记录水库,但并不代表图片生成完成,图片生成后会请求 callBackHref
  15. window.location.href ="/diy/user/index";
  16. }
  17. });
js

JSON 对象错误

我们使用传统的 HTTP 状态,表示 API 请求成功或失败,并在返回的 JSON 对象错误中包括重要的错误信息。

我们努力始终为任何有问题的请求返回 JSON 对象错误。 但是,从理论上来说,总是可能出现内部服务器故障,从而导致非 JSON 错误回应。

属性

status 回应的 HTTP 状态在此重复,以帮助调试。
code FOXPSD 内部错误代码。
msg 人类可读错误消息,旨在帮助调试。

如果您的请求的 HTTP 状态是 200,则不会返回 JSON 对象错误,您可以安全地假设请求总体而言已取得成功。

一些 HTTP 客户端库为 400-599 范围内的 HTTP 状态引发异常。 您将需要捕获这些异常,并适当处理。

HTTP Status 表示
200-299

成功

400-499

请求中提供的信息存在问题(例如,缺少一个参数)。 请查看错误消息,了解如何纠错。

500-599

出现 FOXPSD 内部错误。 请稍候,然后再重新尝试,如果问题依然存在,请及时联系我们。

FOXPSD 内部code 表示的含义

FOXPSD code 表示
10000

成功

10001

失败,可能是参数验证错误,权限错误等等,请开发者自行检查

10002

token 失效,用于重新登录逻辑

错误回应示例

  1. {
  2. code:10001, //状态码
  3. msg:'权限不足', //提示信息
  4. data:null //可能包含的具体内容
  5. }
json

正确回应示例

  1. {
  2. "code": 10000,
  3. "data": {
  4. "sku": "1637826540047353433"
  5. },
  6. "msg": "请求成功"
  7. }
json

API: 模板分类列表 GET /api/diy/template/type

查询模板分类

参数

无需参数

结果

code
数字
取值范围为 10000 :操作成功;10001 :操作失败
msg
字符串
信息提示
data.idx
字符串

排序

data.children
数组

分类下一级

data.parent_id
数字

分类上一级id

data.status
数字

用户是否被禁用,取值范围【0,1】默认1

0 禁用
1 正常
data.title
字符串

标题

data.business_appid
字符串

商家appid 标识

请求演示

  1. //下面是以jquery 的ajax方法进行演示,服务端请用相关的语言发送http请求即可
  2. $.ajax({
  3. type:'GET',
  4. url:'https://foxpsd.com/api/diy/template/type,
  5. headers:{
  6. 'Content-Type': 'application/json',
  7. // 填写你的token 进行身份识别
  8. 'Authorization':'Basic xxxxxxxxxxxxxxxxxxxxxxxxxxxx'
  9. },
  10. success(res){
  11. //操作成功
  12. if (res.code == '10000') {
  13. console.log(res)
  14. }else{
  15. console.log(res)
  16. }
  17. },
  18. error(err){
  19. console.log(err)
  20. }
  21. })
js
返回结果
  1. {
  2. "code": 10000,
  3. "data": {
  4. "list": [
  5. {
  6. "id": 1,
  7. "title": "服装类",
  8. "idx": 2,
  9. "parent_id": null,
  10. "business_appid": "1637200300570",
  11. "status": 1,
  12. "create_date": "2021-12-27 15:59:41",
  13. "children": [
  14. {
  15. "id": 2,
  16. "title": "短袖T恤",
  17. "idx": 1,
  18. "parent_id": 1,
  19. "business_appid": "1637200300570",
  20. "status": 1,
  21. "create_date": "2021-12-27 15:59:56",
  22. "children": [
  23. {
  24. "id": 4,
  25. "title": "女装",
  26. "idx": 1,
  27. "parent_id": 2,
  28. "business_appid": "1637200300570",
  29. "status": 1,
  30. "create_date": "2021-12-27 16:00:21"
  31. },
  32. {
  33. "id": 3,
  34. "title": "男装",
  35. "idx": 2,
  36. "parent_id": 2,
  37. "business_appid": "1637200300570",
  38. "status": 1,
  39. "create_date": "2021-12-27 16:00:09"
  40. }
  41. ]
  42. }
  43. ]
  44. }
  45. ]
  46. },
  47. "msg": "请求成功"
  48. }
json

API: 模板保存或编辑POST /api/diy/template/save

保存或创建模板,传输参数sku表示编辑模板

参数

sku
字符串
非必传
模板的sku,传输则表示编辑
bianma
字符串
必传
会合成到尺码图中,只支持字母和数字组合,请做好限制
type_id
数字
必传
模板分类的最末级id
idx
数字
必传
排序,最小值为1
render
数字
非必传

默认是浏览器渲染,浏览器渲染性能更好,非特殊需求不建议更改

1 服务器渲染
2 浏览器选择
img_url
字符串
必传
模板主图,请上传完整地http链接(推荐使用https)图片尺寸为750乘以750像素,72分辨率

结果

code
数字
取值范围为 10000 :操作成功;10001 :操作失败
msg
字符串
信息提示
data.sku
字符串

唯一标识,需要存储到自己的服务器,用于后面的操作

data.img_url
字符串

模板主图

data.bianma
字符串

模板编码

data.type_id
数字

分类id

data.status
数字

用户是否被禁用,取值范围【0,1】默认1

0 禁用
1 正常
data.title
字符串

模板名称

data.business_appid
字符串

商家appid 标识

请求演示

  1. $.ajax({
  2. type:'POST',
  3. url:'https://foxpsd.com/api/diy/template/save',
  4. data:JSON.stringify({
  5. title:'创建模板888',
  6. bianma:'diy123',
  7. type_id:3,
  8. idx:1,
  9. img_url:"https://img.foxpsd.com/1637200300570/20220212/1644632160038646993.jpg",
  10. content:"我是描述"
  11. }),
  12. headers:{
  13. 'Content-Type': 'application/json',
  14. // 填写你的token 进行身份识别
  15. 'Authorization':'Basic xxxxxxxxxxxxxxxxxxxxxxxxxxxx'
  16. },
  17. success(res){
  18. //操作成功
  19. if (res.code == '10000') {
  20. console.log(res)
  21. }else{
  22. console.log(res)
  23. }
  24. },
  25. error(err){
  26. console.log(err)
  27. }
  28. })
js
返回结果
  1. {
  2. "code": 10000,
  3. "data": {
  4. "status": 1,
  5. "create_date": "2022-03-09T06:58:00.114Z",
  6. "id": 5,
  7. "title": "创建模板888",
  8. "bianma": "diy123",
  9. "type_id": 3,
  10. "idx": 1,
  11. "img_url": "https://img.foxpsd.com/1637200300570/20220212/1644632160038646993.jpg",
  12. "content": "11111111111111111",
  13. "leixing": 1,
  14. "business_appid": "1637200300570",
  15. "sku": "1646809080114882792"
  16. },
  17. "msg": "请求成功"
  18. }
json

API: 模板列表 POST /api/diy/template/listFindAndCountAll

查询模板列表

参数

page
数字
非必传
分页数 默认值为 1
rows
数字
非必传
分页限制条数 默认值:20条
tid
数字
非必传
任意一级分类id
status
数字
非必传
取值范围为【0,1】0 为禁用,1正常,不传则查询全部
usku
字符串
非必传
用户sku,一般用于筛选是否有权限查看模板
content
字符串
非必传
搜索用户列表的 sku或者模板title

结果

code
数字
取值范围为 10000 :操作成功;10001 :操作失败
msg
字符串
信息提示
data.list
字符串

模板 list,字段详情请查看详情接口的介绍

data.totalPage
数字

总页数

data.totalRow
数字

总条数

data.curPage
数字

当前页数

data.list[].sku
字符串

唯一标识,需要存储到自己的服务器,用于后面的操作

data.list[].img_url
字符串

模板主图

data.list[].status
数字

用户是否被禁用,取值范围【0,1】默认1

0 禁用
1 正常
data.list[].bianma
字符串

自定义编码,会合成到生产图中

data.list[].content
字符串

描述信息

data.list[].user_ids
字符串

存放用户的id,存在则表示当前用户有权查看,为null则表示全部可查看

data.list[].business_appid
字符串

商家appid 标识

请求演示

  1. $.ajax({
  2. type:'POST',
  3. url:'https://foxpsd.com/api/diy/template/listFindAndCountAll',
  4. data:JSON.stringify({
  5. page:1,
  6. rows:20
  7. }),
  8. headers:{
  9. 'Content-Type': 'application/json',
  10. // 填写你的token 进行身份识别
  11. 'Authorization':'Basic xxxxxxxxxxxxxxxxxxxxxxxxxxxx'
  12. },
  13. success(res){
  14. //操作成功
  15. if (res.code == '10000') {
  16. console.log(res)
  17. }else{
  18. console.log(res)
  19. }
  20. },
  21. error(err){
  22. console.log(err)
  23. }
  24. })
js
返回结果
  1. {
  2. "code": 10000,
  3. "data": {
  4. "list": [
  5. {
  6. "id": 1,
  7. "sku": "1640592254320072840",
  8. "title": "相册",
  9. "idx": 1,
  10. "img_url": "https://img.foxpsd.com/1637200300570/20211227/1640592248874201208.jpg",
  11. "bianma": "weiyi",
  12. "content": "特色卫衣",
  13. "leixing": 1,
  14. "kuandu": null,
  15. "gaodu": null,
  16. "mask_url": null,
  17. "user_ids": null,
  18. "type_id": 8,
  19. "business_appid": "1637200300570",
  20. "status": 1,
  21. "create_date": "2021-12-27 16:04:14"
  22. },
  23. {
  24. "id": 2,
  25. "sku": "1640745567946508779",
  26. "title": "卫衣",
  27. "idx": 2,
  28. "img_url": "https://img.foxpsd.com/1637200300570/20211229/1640745565382555334.jpg",
  29. "bianma": "WYQ",
  30. "content": "卫衣",
  31. "leixing": 1,
  32. "kuandu": null,
  33. "gaodu": null,
  34. "mask_url": null,
  35. "user_ids": null,
  36. "type_id": 3,
  37. "business_appid": "1637200300570",
  38. "status": 1,
  39. "create_date": "2021-12-29 10:39:27"
  40. }
  41. ],
  42. "totalPage": 1,
  43. "totalRow": 2,
  44. "curPage": 1
  45. },
  46. "msg": "请求成功"
  47. }
json

API: 创建用户 POST https://foxpsd.com/api/diy/user/create

用户创建用户,与foxpsd进行账户打通

参数

name
字符串
必传
用户昵称,也为用户的登录账号,有唯一性检查
password
字符串
必传
6-12位密码
img_url
字符串
非必传

有效的http 远程图片,可用于用户头像展示

结果

code
数字
取值范围为 10000 :操作成功;10001 :操作失败
msg
字符串
信息提示
data.sku
字符串

唯一标识,需要存储到自己的服务器,用于后面的操作

data.img_url
字符串

用户头像 推荐尺寸为200*200像素

data.chima_status
数字

用户是否可生成生产图,取值范围【0,1】默认1

0 禁用生成
1 正常
data.status
数字

用户是否被禁用,取值范围【0,1】默认1

0 禁用
1 正常
data.name
字符串

用户昵称

data.business_appid
字符串

商家appid 标识

请求演示

  1. //下面是以jquery 的ajax方法进行演示,服务端请用相关的语言发送http请求即可
  2. $.ajax({
  3. type:'POST',
  4. url:'https://foxpsd.com/api/diy/user/create',
  5. data:JSON.stringify({
  6. name:"李四1234",
  7. password:"123456"
  8. }),
  9. headers:{
  10. 'Content-Type': 'application/json',
  11. // 填写你的token 进行身份识别
  12. 'Authorization':'Basic xxxxxxxxxxxxxxxxxxxxxxxxxxxx'
  13. },
  14. success(res){
  15. //操作成功
  16. if (res.code == '10000') {
  17. console.log(res)
  18. }else{
  19. console.log(res)
  20. }
  21. },
  22. error(err){
  23. console.log(err)
  24. }
  25. })
js
返回结果
  1. {
  2. "code": 10000,
  3. "data": {
  4. "sku": "4a4625c8-49ee-4871-bfa6-71e2c3df052e",
  5. "img_url": "https://img.foxpsd.com/moren_user.png",
  6. "chima_status": 1,
  7. "status": 1,
  8. "create_date": "2022-02-28T06:30:30.531Z",
  9. "update_date": "2022-02-28T06:30:30.531Z",
  10. "id": 12,
  11. "name": "李四1234",
  12. "password": "********",
  13. "business_appid": "1637200300570"
  14. },
  15. "msg": "请求成功"
  16. }
json

API: 用户列表 POST /api/diy/user/list

查询用户列表

参数

page
数字
非必传
分页数 默认值为 1
rows
数字
非必传
分页限制条数 默认值:20条
content
字符串
非必传
搜索用户列表的 sku或者name

结果

code
数字
取值范围为 10000 :操作成功;10001 :操作失败
msg
字符串
信息提示
data.list
字符串

用户 list,字段详情请查看详情接口的介绍

data.totalPage
数字

总页数

data.totalRow
数字

总条数

data.curPage
数字

当前页数

请求演示

  1. //下面是以jquery 的ajax方法进行演示,服务端请用相关的语言发送http请求即可
  2. $.ajax({
  3. type:'POST',
  4. url:'https://foxpsd.com/api/diy/user/list',
  5. data:JSON.stringify({
  6. page:1,
  7. rows:20
  8. }),
  9. headers:{
  10. 'Content-Type': 'application/json',
  11. // 填写你的token 进行身份识别
  12. 'Authorization':'Basic xxxxxxxxxxxxxxxxxxxxxxxxxxxx'
  13. },
  14. success(res){
  15. //操作成功
  16. if (res.code == '10000') {
  17. console.log(res)
  18. }else{
  19. console.log(res)
  20. }
  21. },
  22. error(err){
  23. console.log(err)
  24. }
  25. })
js
返回结果
  1. {
  2. "code": 10000,
  3. "data": {
  4. "list": [
  5. {
  6. "id": 12,
  7. "sku": "4a4625c8-49ee-4871-bfa6-71e2c3df052e",
  8. "name": "李四1234",
  9. "img_url": "https://img.foxpsd.com/moren_user.png",
  10. "business_appid": "1637200300570",
  11. "chima_status": 1,
  12. "status": 1,
  13. "create_date": "2022-02-28 14:30:30",
  14. "update_date": "2022-02-28 14:30:30"
  15. },
  16. {
  17. "id": 11,
  18. "sku": "27ced367-4a47-4efd-bc35-baa4851f7a8a",
  19. "name": "李四123",
  20. "img_url": "https://img.foxpsd.com/moren_user.png",
  21. "business_appid": "1637200300570",
  22. "chima_status": 1,
  23. "status": 1,
  24. "create_date": "2022-02-28 14:27:31",
  25. "update_date": "2022-02-28 14:27:31"
  26. }
  27. }
  28. },
  29. "msg": "请求成功",
  30. "totalPage": 1,
  31. "totalRow": 7,
  32. "curPage": 1
  33. }
json

API: 用户详情 GET /api/diy/user

查询用户详情

参数

sku
字符串
必传
用户sku值

结果

code
数字
取值范围为 10000 :操作成功;10001 :操作失败
msg
字符串
信息提示
data.sku
字符串

唯一标识,需要存储到自己的服务器,用于后面的操作

data.img_url
字符串

用户头像

data.chima_status
数字

用户是否可生成生产图,取值范围【0,1】默认1

0 禁用生成
1 正常
data.status
数字

用户是否被禁用,取值范围【0,1】默认1

0 禁用
1 正常
data.name
字符串

用户昵称

data.business_appid
字符串

商家appid 标识

请求演示

  1. //下面是以jquery 的ajax方法进行演示,服务端请用相关的语言发送http请求即可
  2. $.ajax({
  3. type:'GET',
  4. url:'/api/diy/user?sku=d904e201-51db-4dc4-ab75-74e869cdc32a,
  5. headers:{
  6. 'Content-Type': 'application/json',
  7. // 填写你的token 进行身份识别
  8. 'Authorization':'Basic xxxxxxxxxxxxxxxxxxxxxxxxxxxx'
  9. },
  10. success(res){
  11. //操作成功
  12. if (res.code == '10000') {
  13. console.log(res)
  14. }else{
  15. console.log(res)
  16. }
  17. },
  18. error(err){
  19. console.log(err)
  20. }
  21. })
js
返回结果
  1. {
  2. "code": 10000,
  3. "data": {
  4. "id": 10,
  5. "sku": "d904e201-51db-4dc4-ab75-74e869cdc32a",
  6. "name": "李四2",
  7. "img_url": "https://img.foxpsd.com/moren_user.png",
  8. "business_appid": "1637200300570",
  9. "chima_status": 1,
  10. "status": 1,
  11. "create_date": "2022-02-25 16:25:20",
  12. "update_date": "2022-02-26 13:53:03"
  13. },
  14. "msg": "请求成功"
  15. }
json

API: 用户编辑 POST /api/diy/user/edit

编辑用户头像,密码,状态,是否生成生产图状态

参数

sku
字符串
必传
用户sku值
password
字符串
非必传
用户新密码
chima_status
数字
非必传
取值范围【0,1】,是否允许用户生成生产图
status
数字
非必传
取值范围【0,1】,用户禁用或启用

结果

code
数字
取值范围为 10000 :操作成功;10001 :操作失败
msg
字符串
信息提示

请求演示

  1. //下面是以jquery 的ajax方法进行演示,服务端请用相关的语言发送http请求即可
  2. $.ajax({
  3. type:'POST',
  4. url:'https://foxpsd.com/api/diy/user/edit',
  5. data:JSON.stringify({
  6. sku:"d904e201-51db-4dc4-ab75-74e869cdc32a",
  7. password:"852741"
  8. }),
  9. headers:{
  10. 'Content-Type': 'application/json',
  11. // 填写你的token 进行身份识别
  12. 'Authorization':'Basic xxxxxxxxxxxxxxxxxxxxxxxxxxxx'
  13. },
  14. success(res){
  15. //操作成功
  16. if (res.code == '10000') {
  17. console.log(res)
  18. }else{
  19. console.log(res)
  20. }
  21. },
  22. error(err){
  23. console.log(err)
  24. }
  25. })
js
返回结果
  1. {
  2. "code": 10000,
  3. "data": null,
  4. "msg": "请求成功"
  5. }
json

API: 用户删除 POST /api/diy/user/delete

删除用户,用户关联的数据也会一并删除,请谨慎操作

参数

sku
字符串
必传
用户sku值

结果

code
数字
取值范围为 10000 :操作成功;10001 :操作失败
msg
字符串
信息提示

请求演示

  1. //下面是以jquery 的ajax方法进行演示,服务端请用相关的语言发送http请求即可
  2. $.ajax({
  3. type:'POST',
  4. url:'https://foxpsd.com/api/diy/user/delete',
  5. data:JSON.stringify({
  6. sku:"d904e201-51db-4dc4-ab75-74e869cdc32a"
  7. }),
  8. headers:{
  9. 'Content-Type': 'application/json',
  10. // 填写你的token 进行身份识别
  11. 'Authorization':'Basic xxxxxxxxxxxxxxxxxxxxxxxxxxxx'
  12. },
  13. success(res){
  14. //操作成功
  15. if (res.code == '10000') {
  16. console.log(res)
  17. }else{
  18. console.log(res)
  19. }
  20. },
  21. error(err){
  22. console.log(err)
  23. }
  24. })
js
返回结果
  1. {
  2. "code": 10000,
  3. "data": null,
  4. "msg": "请求成功"
  5. }
json

API: 用户保存记录 POST /api/diy/userSave/list

用户保存的编辑器数据,服务器只存储七天的生成数据,请及时另存储

参数

usku
字符串
非必传
用户sku值,传入表示搜索当前用户下的数据
page
数字
非必传
分页数 默认值为 1
rows
数字
非必传
分页限制条数 默认值:20条,最大值1000条
content
字符串
非必传
搜索sku,或者自定义编码

结果

code
数字
取值范围为 10000 :操作成功;10001 :操作失败
msg
字符串
信息提示
data.list
字符串

保存 list,字段详情请查看详情接口的介绍

data.totalPage
数字

总页数

data.totalRow
数字

总条数

data.curPage
数字

当前页数

请求演示

  1. //下面是以jquery 的ajax方法进行演示,服务端请用相关的语言发送http请求即可
  2. $.ajax({
  3. type:'POST',
  4. url:'https://foxpsd.com/api/diy/userSave/list',
  5. data:JSON.stringify({
  6. usku:"d904e201-51db-4dc4-ab75-74e869cdc32a"
  7. }),
  8. headers:{
  9. 'Content-Type': 'application/json',
  10. // 填写你的token 进行身份识别
  11. 'Authorization':'Basic xxxxxxxxxxxxxxxxxxxxxxxxxxxx'
  12. },
  13. success(res){
  14. //操作成功
  15. if (res.code == '10000') {
  16. console.log(res)
  17. }else{
  18. console.log(res)
  19. }
  20. },
  21. error(err){
  22. console.log(err)
  23. }
  24. })
js
返回结果
  1. {
  2. "code": 10000,
  3. "data": {
  4. "list": [
  5. {
  6. "id": 89,
  7. "sku": "1645860233088609238",
  8. "bianma": "wy01_1112_WY01L",
  9. "ewm": "/1637200300570/ewm/20220226/9dPcIx0Uat7fRlla.jpg",
  10. "business_goods_type_sku": "1640591909487642659",
  11. "diy_id": 3,
  12. "diy_content": null,
  13. "face_list_content": {
  14. "3": {
  15. "title": "全幅印花",
  16. "content": "{\"version\":\"4.6.0\",\"objects\":[{\"type\":\"rect\",\"version\":\"4.6.0\",\"originX\":\"left\",\"originY\":\"top\",\"left\":424.35,\"top\":97.85,\"width\":365.3,\"height\":365.3,\"fill\":\"rgba(255,255,255,0)\",\"stroke\":null,\"strokeWidth\":1,\"strokeDashArray\":null,\"strokeLineCap\":\"butt\",\"strokeDashOffset\":0,\"strokeLineJoin\":\"miter\",\"strokeUniform\":false,\"strokeMiterLimit\":4,\"scaleX\":1,\"scaleY\":1,\"angle\":0,\"flipX\":false,\"flipY\":false,\"opacity\":1,\"shadow\":null,\"visible\":true,\"backgroundColor\":\"\",\"fillRule\":\"nonzero\",\"paintFirst\":\"fill\",\"globalCompositeOperation\":\"source-over\",\"skewX\":0,\"skewY\":0,\"rx\":0,\"ry\":0,\"mediaType\":\"bg\",\"objectCaching\":true},{\"type\":\"image\",\"version\":\"4.6.0\",\"originX\":\"left\",\"originY\":\"top\",\"left\":424.85,\"top\":98.35,\"width\":6600,\"height\":6600,\"fill\":\"rgb(0,0,0)\",\"stroke\":null,\"strokeWidth\":0,\"strokeDashArray\":null,\"strokeLineCap\":\"butt\",\"strokeDashOffset\":0,\"strokeLineJoin\":\"miter\",\"strokeUniform\":false,\"strokeMiterLimit\":4,\"scaleX\":0.05534848484848486,\"scaleY\":0.05534848484848486,\"angle\":0,\"flipX\":false,\"flipY\":false,\"opacity\":1,\"shadow\":null,\"visible\":true,\"backgroundColor\":\"\",\"fillRule\":\"nonzero\",\"paintFirst\":\"fill\",\"globalCompositeOperation\":\"source-over\",\"skewX\":0,\"skewY\":0,\"cropX\":0,\"cropY\":0,\"origWidth\":6600,\"origHeight\":6600,\"originImgUrl\":\"https://img.foxpsd.com/1637200300570/20220212/1644647353017786664.png\",\"mediaType\":\"material\",\"filters\":[],\"src\":\"https://img.foxpsd.com/1637200300570/20220212/1644647353017786664.png\",\"objectCaching\":true,\"crossOrigin\":\"anonymous\"}],\"id\":\"canvas_3\",\"width\":1215,\"height\":562,\"oldCutWidth\":365.3,\"oldCutHeight\":365.3,\"origWidth\":1000,\"origHeight\":1000,\"objectCaching\":false}",
  17. "img_url": "https://img.foxpsd.com/1637200300570/5/20220226/164585993894558ec32e73.png"
  18. }
  19. },
  20. "xiaoguotu_list_content": {
  21. "xgid_8": {
  22. "id": 8,
  23. "title": "正面效果图",
  24. "img_url": "https://img.foxpsd.com/1637200300570/20220226/16458602332423766.jpg"
  25. }
  26. },
  27. "chima_list_content": {
  28. "cmid_3": {
  29. "id": 3,
  30. "title": "L码",
  31. "bianma": "WY01L",
  32. "img_url": "https://img.foxpsd.com/1637200300570/20220226/164586023331466854.jpg"
  33. }
  34. },
  35. "callback": "http://127.0.0.1:7002/api/diy/test",
  36. "status": 1,
  37. "user_id": 5,
  38. "business_appid": "1637200300570",
  39. "create_date": "2022-02-26 15:23:53",
  40. "update_date": "2022-02-26 15:23:58",
  41. "db_diy": {
  42. "id": 3,
  43. "sku": "1644632141987787215",
  44. "title": "男士卫衣",
  45. "idx": 1,
  46. "img_url": "https://img.foxpsd.com/1637200300570/20220212/1644632160038646993.jpg",
  47. "bianma": "wy01",
  48. "content": "男士经典款卫衣",
  49. "leixing": 1,
  50. "kuandu": null,
  51. "gaodu": null,
  52. "mask_url": null,
  53. "user_ids": "5,7",
  54. "type_id": 3,
  55. "business_appid": "1637200300570",
  56. "status": 1,
  57. "create_date": "2022-02-12 10:15:41"
  58. }
  59. },
  60. "totalPage": 1,
  61. "totalRow": 6,
  62. "curPage": 1
  63. },
  64. "msg": "请求成功"
json

API: 用户保存详情GET /api/diy/userSave/item

查看保存记录详情

参数

sku
字符串
必传
用户保存记录的sku值

结果

code
数字
取值范围为 10000 :操作成功;10001 :操作失败
data.sku
字符串
保存记录sku
data.bianma
字符串
自定义编码
data.ewm
字符串
二维码链接(此字段后期可能会更改)
data.business_goods_type_sku
字符串
编辑器sku
data.face_list_content
json
层面数据
data.xiaoguotu_list_content
json
效果图数据
data.chima_list_content
json
尺码图数据
data.callback
字符串
保存完成后回调地址
data.status
数字

生成状态,取值范围【0,1,9】默认9

0 生成失败
1 生成完成
9 待生成
data.db_diy
json
关联模板数据

请求演示

  1. //下面是以jquery 的ajax方法进行演示,服务端请用相关的语言发送http请求即可
  2. $.ajax({
  3. type:'GET',
  4. url:'https://foxpsd.com/api/diy/userSave/item?sku=1645860233088609238',
  5. headers:{
  6. 'Content-Type': 'application/json',
  7. // 填写你的token 进行身份识别
  8. 'Authorization':'Basic xxxxxxxxxxxxxxxxxxxxxxxxxxxx'
  9. },
  10. success(res){
  11. //操作成功
  12. if (res.code == '10000') {
  13. console.log(res)
  14. }else{
  15. console.log(res)
  16. }
  17. },
  18. error(err){
  19. console.log(err)
  20. }
  21. })
js
返回结果
  1. {
  2. "code": 10000,
  3. "data": {
  4. "id": 89,
  5. "sku": "1645860233088609238",
  6. "bianma": "wy01_1112_WY01L",
  7. "ewm": "/1637200300570/ewm/20220226/9dPcIx0Uat7fRlla.jpg",
  8. "business_goods_type_sku": "1640591909487642659",
  9. "diy_id": 3,
  10. "diy_content": null,
  11. "face_list_content": {
  12. "3": {
  13. "title": "全幅印花",
  14. "content": "{\"version\":\"4.6.0\",\"objects\":[{\"type\":\"rect\",\"version\":\"4.6.0\",\"originX\":\"left\",\"originY\":\"top\",\"left\":424.35,\"top\":97.85,\"width\":365.3,\"height\":365.3,\"fill\":\"rgba(255,255,255,0)\",\"stroke\":null,\"strokeWidth\":1,\"strokeDashArray\":null,\"strokeLineCap\":\"butt\",\"strokeDashOffset\":0,\"strokeLineJoin\":\"miter\",\"strokeUniform\":false,\"strokeMiterLimit\":4,\"scaleX\":1,\"scaleY\":1,\"angle\":0,\"flipX\":false,\"flipY\":false,\"opacity\":1,\"shadow\":null,\"visible\":true,\"backgroundColor\":\"\",\"fillRule\":\"nonzero\",\"paintFirst\":\"fill\",\"globalCompositeOperation\":\"source-over\",\"skewX\":0,\"skewY\":0,\"rx\":0,\"ry\":0,\"mediaType\":\"bg\",\"objectCaching\":true},{\"type\":\"image\",\"version\":\"4.6.0\",\"originX\":\"left\",\"originY\":\"top\",\"left\":424.85,\"top\":98.35,\"width\":6600,\"height\":6600,\"fill\":\"rgb(0,0,0)\",\"stroke\":null,\"strokeWidth\":0,\"strokeDashArray\":null,\"strokeLineCap\":\"butt\",\"strokeDashOffset\":0,\"strokeLineJoin\":\"miter\",\"strokeUniform\":false,\"strokeMiterLimit\":4,\"scaleX\":0.05534848484848486,\"scaleY\":0.05534848484848486,\"angle\":0,\"flipX\":false,\"flipY\":false,\"opacity\":1,\"shadow\":null,\"visible\":true,\"backgroundColor\":\"\",\"fillRule\":\"nonzero\",\"paintFirst\":\"fill\",\"globalCompositeOperation\":\"source-over\",\"skewX\":0,\"skewY\":0,\"cropX\":0,\"cropY\":0,\"origWidth\":6600,\"origHeight\":6600,\"originImgUrl\":\"https://img.foxpsd.com/1637200300570/20220212/1644647353017786664.png\",\"mediaType\":\"material\",\"filters\":[],\"src\":\"https://img.foxpsd.com/1637200300570/20220212/1644647353017786664.png\",\"objectCaching\":true,\"crossOrigin\":\"anonymous\"}],\"id\":\"canvas_3\",\"width\":1215,\"height\":562,\"oldCutWidth\":365.3,\"oldCutHeight\":365.3,\"origWidth\":1000,\"origHeight\":1000,\"objectCaching\":false}",
  15. "img_url": "https://img.foxpsd.com/1637200300570/5/20220226/164585993894558ec32e73.png"
  16. }
  17. },
  18. "xiaoguotu_list_content": {
  19. "xgid_8": {
  20. "id": 8,
  21. "title": "正面效果图",
  22. "img_url": "https://img.foxpsd.com/1637200300570/20220226/16458602332423766.jpg"
  23. }
  24. },
  25. "chima_list_content": {
  26. "cmid_3": {
  27. "id": 3,
  28. "title": "L码",
  29. "bianma": "WY01L",
  30. "img_url": "https://img.foxpsd.com/1637200300570/20220226/164586023331466854.jpg"
  31. }
  32. },
  33. "callback": "http://127.0.0.1:7002/api/diy/test",
  34. "status": 1,
  35. "user_id": 5,
  36. "business_appid": "1637200300570",
  37. "create_date": "2022-02-26 15:23:53",
  38. "update_date": "2022-02-26 15:23:58",
  39. "db_diy": {
  40. "id": 3,
  41. "sku": "1644632141987787215",
  42. "title": "男士卫衣",
  43. "idx": 1,
  44. "img_url": "https://img.foxpsd.com/1637200300570/20220212/1644632160038646993.jpg",
  45. "bianma": "wy01",
  46. "content": "男士经典款卫衣",
  47. "leixing": 1,
  48. "kuandu": null,
  49. "gaodu": null,
  50. "mask_url": null,
  51. "user_ids": "5,7",
  52. "type_id": 3,
  53. "business_appid": "1637200300570",
  54. "status": 1,
  55. "create_date": "2022-02-12 10:15:41"
  56. }
  57. },
  58. "msg": "请求成功"
  59. }
json

API: 用户保存下载记录列表POST /api/diy/userSave/down/list

生成zip压缩包的列表

参数

usku
字符串
非必传
用户sku值
content
字符串
非必传
搜索下载记录sku
page
数字
非必传
分页数 默认值为 1
rows
数字
非必传
分页限制条数 默认值:20条

结果

code
数字
取值范围为 10000 :操作成功;10001 :操作失败
msg
字符串
信息提示
data.list
字符串

下载 list,字段详情请查看详情接口的介绍

data.totalPage
数字

总页数

data.totalRow
数字

总条数

data.curPage
数字

当前页数

请求演示

  1. //下面是以jquery 的ajax方法进行演示,服务端请用相关的语言发送http请求即可
  2. $.ajax({
  3. type:'POST',
  4. url:'https://foxpsd.com/api/diy/userSave/down/list',
  5. data:JSON.stringify({
  6. usku:"11113333",
  7. page:1,
  8. rows:20
  9. }),
  10. headers:{
  11. 'Content-Type': 'application/json',
  12. // 填写你的token 进行身份识别
  13. 'Authorization':'Basic xxxxxxxxxxxxxxxxxxxxxxxxxxxx'
  14. },
  15. success(res){
  16. //操作成功
  17. if (res.code == '10000') {
  18. console.log(res)
  19. }else{
  20. console.log(res)
  21. }
  22. },
  23. error(err){
  24. console.log(err)
  25. }
  26. })
js
返回结果
  1. {
  2. "code": 10000,
  3. "data": {
  4. "list": [
  5. {
  6. "id": 20,
  7. "sku": "1646035479475512929",
  8. "persistent_id": "z2.01z201ci7ivodhvd7700mtsbry0001io",
  9. "zip": "https://img.foxpsd.com/1637200300570/1646035479475512929.zip",
  10. "status": 9,
  11. "user_id": 7,
  12. "business_appid": "1637200300570",
  13. "create_date": "2022-02-28 16:04:39"
  14. },
  15. ],
  16. "totalPage": 1,
  17. "totalRow": 4,
  18. "curPage": 1
  19. },
  20. "msg": "请求成功"
  21. }
json

API: 用户保存下载记录详情GET /api/diy/userSave/down/item

生成zip压缩包的详情

参数

sku
字符串
必传
下载记录sku值

结果

code
数字
取值范围为 10000 :操作成功;10001 :操作失败
msg
字符串
信息提示
data.sku
字符串
下载记录的唯一标识
data.zip
字符串
远程的zip下载链接
data.business_appid
字符串
所属商家appid
data.status
数字

生成状态,取值范围【0,1,9】默认9

0 生成失败
1 生成完成
9 待生成

请求演示

  1. //下面是以jquery 的ajax方法进行演示,服务端请用相关的语言发送http请求即可
  2. $.ajax({
  3. type:'GET',
  4. url:'https://foxpsd.com/api/diy/userSave/down/item?sku=1645857529081629793',
  5. headers:{
  6. 'Content-Type': 'application/json',
  7. // 填写你的token 进行身份识别
  8. 'Authorization':'Basic xxxxxxxxxxxxxxxxxxxxxxxxxxxx'
  9. },
  10. success(res){
  11. //操作成功
  12. if (res.code == '10000') {
  13. console.log(res)
  14. }else{
  15. console.log(res)
  16. }
  17. },
  18. error(err){
  19. console.log(err)
  20. }
  21. })
js
返回结果
  1. {
  2. "code": 10000,
  3. "data": {
  4. "status": 9,
  5. "create_date": "2022-02-28T08:04:39.977Z",
  6. "id": 20,
  7. "sku": "1646035479475512929",
  8. "persistent_id": "z2.01z201ci7ivodhvd7700mtsbry0001io",
  9. "zip": "https://img.foxpsd.com/1637200300570/1646035479475512929.zip",
  10. "business_appid": "1637200300570",
  11. "user_id": 7
  12. },
  13. "msg": "请求成功"
  14. }
json
客服微信
加好友可获得
免费次数
咨询电话:
176-6401-7800