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

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

注意事项

  • 该接口采用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