发表评论

接口名称

/posts/create

接口说明

发表评论。

URL

http://api.duoshuo.com/posts/create.`返回格式`

返回格式支持:json, jsonp

HTTP请求方式

POST

是否需要登录

请求参数

short_name 必需

站点申请的多说二级域名。

secret 必需

站点密钥。

message 必需

评论内容。

thread_key 可选

被评论文章在原站点的文章标识。如果有thread_id,此参数是可选参数,否则是必选参数。

thread_id 可选

被评论文章的多说文章ID。如果有thread_key,此参数是可选参数,否则是必选参数。

parent_id 可选

父评论(被回复的评论)的ID。

author_name 可选

作者名字。如果已登陆多说,此参数是可选参数,否则是必选参数。

author_email 可选

作者邮箱。如果已登陆多说,此参数是可选参数,否则是必选参数。

author_url 可选

作者网址。

remote_auth 可选

remote_auth串是判断用户是否登录的依据。remote_auth生成方式请参考: 多说本地身份说明(Remote Auth) message

jwt 可选

用户身份信息。

access_token 可选

单点登录获取的access_token

请求示例

匿名发表新评论

Request URL:http://api.duoshuo.com/posts/create.json

Request Method:POST

Status Code:200 OK

Post Data:

short_name=official&author_email=jp.chenyang%40gmail.com&author_name=Perchouli&thread_id=1152923703638301959&author_url=http%3A%2F%2Fduoshuo.com&message=匿名发表新评论

登陆后发表评论

Request URL:http://api.duoshuo.com/posts/create.json

Request Method:POST

Status Code:200 OK

Post Data:

thread_id=1152923703638301959&message=登陆多说发表评论&remote_auth=remote_auth%3AW10%3D+f6b2d4ddd2c960d9a4fa41cefee55bdb1876bea8+1354681746&short_name=official

返回数据示例

{
    "code":0,
    "response":
        {"post_id":"1152985276292923003",
        "parent_id":"1152985276292923000",
        "thread_id":"1152923703638301959",
        "status":"approved",
        "source":"duoshuo",
        "author_key":"1",
        "author_name":"Perchouli",
        "author_url":"http://weibo.com/perchouli",
        "message":"登陆多说发表评论",
        "created_at":"2012-11-01T11:36:38+08:00",
        "likes":0,
        "reports":0,
        "comments":0,
        "reposts":0,
        "type":"",
        "privileges":
            {"delete":true,
            "update":true,
            "moderate":true},
        "author":
            {"user_id":"2288",
            "name":"Perchouli",
            "url":"http://weibo.com/perchouli",
            "avatar_url":"http://tp3.sinaimg.cn/1893629610/50/1292295250/1",
            "domain":"",
            "connected_services":
                {"weibo":"1893629610",
                "douban":"3382783",
                "baidu":"839143886"}
        }
    }
}

返回数据参数说明

code int 一定返回

结果码。0为成功。失败时为错误码。

errorMessage string

错误消息。当code不为0时,返回错误消息。

response object

多说api返回结果中,通常在response中含有主要返回数据。当code为0时返回。

post_id int64 一定返回

评论id。请注意,post_id为64位二进制整数,MySQL数据类型建议定义为bigInt。

parent_id int64

父评论id。如果是回复一条评论,返回数据中带有parent_id。请注意,parent_id为64位二进制整数,MySQL数据类型建议定义为bigInt。

thread_id int64 一定返回

文章id。请注意,thread_id为64位二进制整数,MySQL数据类型建议定义为bigInt。

status string 一定返回

评论状态。创建评论时,可能的状态:approved:已经通过;pending:待审核;spam:垃圾评论。

source string 一定返回

评论来源。通过评论框发表的文章这里都是

author_key

作者邮箱。有可能为空字符串。

author_name string 一定返回

作者显示名。有可能为空。

author_url string 一定返回

作者网址。有可能为空字符串。

message string 一定返回

评论的内容。

created_at string 一定返回

评论创建日期,格式示例:2012-07-13T21:58:13+08:00。

likes int 一定返回

评论被点【赞】的次数。

reports int 一定返回

评论被【举报】的次数。

type string 一定返回

类型。现在均为空。