主页 > API > 获取话题详情


获取话题详情

/v1/posts/:post_id
  • URL

    https://api.worktile.com/v1/posts/:post_id

  • HTTP请求方式

    GET

  • 支持格式

    JSON

    Header参数

    {
       "Content-Type":"application/json",
       "access_token":"xxx"
    }
    

    示例

    curl -l https://api.worktile.com/v1/posts/post_idxxx?pid=xxx&access_token=xxx
    
  • HTTP请求参数

    参数 必选 类型 说明
    post_id true string 话题id
    pid true string 项目pid
    access_token true string OAuth授权后获得,请求时可放在header中
  • 返回数据

    示例

    HTTP/1.1 200 ok

    { "post_id":"3bfa535cf599453ca582f5886c185da4", "pid":"eda54f766b7f457ea7cdb5a93c6d892e", "name":"看电影去吧", "summary":"周末一块去看电影吧", "content":"周末一块去看电影吧", "created_at":"2015-03-26T07:37:54.052Z", "updated_at":"2015-03-26T07:37:54.053Z", "owner":{ "uid":"679efdf3960d45a0b8679693098135ff", "name":"gonglinjie", "display_name":"龚moumou", "avatar":"default_avatar.png", "desc":"", "status":3, "online":0 }, "watchers":[ { "uid":"5c9c96dd61044c4eaab437f17dffa6ca", "name":"gongmoumou", "display_name":"龚某某", "avatar":"default_avatar.png", "desc":"", "status":3, "online":0 } ] }


    返回值字段 类型 说明
    post_id string 话题id
    pid string 项目pid
    name string 话题名称
    summary string 话题内容
    content string 话题内容(markdown)
    created_at string 创建时间
    updated_at string 更新时间
    owner object 创建者(用户) 详情 收起
        uid string 用户uid
        name string 用户名
        display_name string 用户昵称
        desc string 用户描述
        avatar string 用户头像
        status number 用户状态:1:正常,2:邀请,3:需要邮件确认
        online number 用户在线状态,0:离线,1:在线,2:忙碌,3:离开
    watchers array 关注话题的成员集合 详情 收起
        uid string 用户uid
        name string 用户名
        display_name string 用户昵称
        desc string 用户描述
        avatar string 用户头像
        status number 用户状态:1:正常,2:邀请,3:需要邮件确认
        online number 用户在线状态,0:离线,1:在线,2:忙碌,3:离开
  • 异常结果

    示例

    HTTP/1.1 404 Not Found

    { "error_code":900005, "error_message":"话题不存在", "request":"/v1/posts/post_idxxx" }


    错误码(error_code) 错误信息(error_message) http状态码(statusCode)
    100005 未授权,请授权后再操作 401
    100006 access_token不正确 400
    900005 话题不存在 404
    900004 获取话题详情失败 500