获取沟通定制订单详情接口

获取沟通定制订单的详细信息,包括订单状态、沟通记录等。

注意事项

  • 该接口采用GET方法,无需提交请求体数据
  • 返回完整的订单信息和沟通记录

请求地址

{域名地址}/api/communication/order/detail

说明:{域名地址} 需要替换成你的域名地址,如 https://www.anqicms.com/api/communication/order/detail

请求语法

GET {域名地址}/api/communication/order/detail

请求头

此接口还涉及公共请求头。更多信息,请参见公共请求头(Common Request Headers)

请求参数

字段名 类型 必填 说明
id int 沟通订单ID

响应头

此接口仅涉及公共响应头。更多信息,请参见公共请求头(Common Request Headers)

返回参数

字段名 类型 说明
code int 错误码
msg string 错误原因说明
data object 订单详情数据

data 结果参数

字段名 类型 说明
id int 沟通订单ID
order_id int 订单ID
user_id int 用户ID
created_time int 创建时间戳
archive_id int 文档ID
phone string 手机号码
images string[] 图片列表
sketch_images string[] 草稿图片列表
finished_images string[] 完成图片列表
title string 订单标题
content string 订单内容
event_date string 时间
status int 状态,进度:0=待处理,1=沟通中,2=已报价待客户确认,3=接受报价,-1=取消,4=拒绝报价
admin_id int 管理员ID
quote_price string 报价价格
quote_content string 报价内容
order_extra object 订单额外信息
order_fields object[] 订单字段信息
user object 用户信息
messages object[] 沟通记录
thumb string 缩略图

messages 沟通记录参数

字段名 类型 说明
id int 沟通记录ID
comm_order_id int 沟通订单ID
sender_id int 发送者ID
sender_type string 发送者类型,user或admin或system
sender_name string 发送者名称
message_type string 沟通记录类型,text 、 image 、 quote 、 video 、 file 、audio 、 location 、 contact 、 sticker 、 unknown
content string 沟通记录内容

使用示例

请求示例

GET /api/communication/order/detail?id=123 HTTP/1.1
Host: www.anqicms.com
Content-Type: application/json

响应示例

{
  "code": 0,
  "msg": "",
  "data": {
    "id": 123,
    "order_id": 456,
    "user_id": 1000,
    "created_time": 1669212548,
    "archive_id": 188,
    "phone": "13888888888",
    "images": [
      "https://www.anqicms.com/uploads/image1.jpg",
      "https://www.anqicms.com/uploads/image2.jpg"
    ],
    "sketch_images": [],
    "finished_images": [],
    "title": "定制网站主题",
    "content": "需要定制一个响应式的外贸网站主题,包含多语言功能",
    "event_date": "2023-12-31",
    "status": 2,
    "admin_id": 1,
    "quote_price": "9900",
    "quote_content": "根据您的需求,定制开发费用为9900元,包含基础功能和后期维护3个月",
    "order_extra": {
      "delivery_time": "2023-12-31",
      "requirement": "需要支持中英文切换"
    },
    "order_fields": [],
    "user": {
      "id": 1000,
      "username": "testuser"
    },
    "messages": [
      {
        "id": 1,
        "comm_order_id": 123,
        "sender_id": 1000,
        "sender_type": "user",
        "sender_name": "testuser",
        "message_type": "text",
        "content": "您好,我想定制一个外贸网站主题"
      },
      {
        "id": 2,
        "comm_order_id": 123,
        "sender_id": 1,
        "sender_type": "admin",
        "sender_name": "admin",
        "message_type": "quote",
        "content": "根据您的需求,定制开发费用为9900元,包含基础功能和后期维护3个月"
      }
    ],
    "thumb": "https://www.anqicms.com/uploads/thumb.jpg"
  }
}

错误代码

错误码 说明
0 OK
-1 错误,错误原因在 msg 中指出
1001 未登录
1002 未授权
200 API 请求 OK