Weibo/insertretweet

出自天涯开放平台资源

跳转到: 导航, 搜索

目录

weibo/insertretweet

发布评论 / 发布对某条评论的回复

URL

http://open.tianya.cn/api/weibo/insertretweet.php

支持格式

JSON / XML

HTTP请求方式

POST

是否需要登录

true,关于授权机制,参见OAuth相关说明

请求参数

参数名	必选	类型	描述
appkey	true	string	申请应用时分配的appkey,调用接口时候代表应用的唯一身份
appkey _secret	true	string	申请应用时分配的appkey _secret
oauth_token	true	string	授权成功后所获得的oauth_token
oauth_token_secret	true	string	授权成功后所获得的oauth_token_secret
params	true	array	参数列表(参见下面详细说明)
outformat	false	string	可选,返回数据格式,默认为json
params参数说明
    "params": 
    {
        "actId":123,         //微博id
        "actUserId":232323,         //微博作者id
        "actUserName":"twitter owner name",         //微博作者天涯帐户名称
        "receivedUserId":2323,             //接收用户id
        "receivedUserName":"xxx",          //接收用户天涯帐户名称
        "content":"content to commit",     //评论内容
        "shareActId":34,            //通过c->b转发时a的id; 否则为0 
        "shareActUserId":34,        //类似上 
        "shareActUserName":"xx",    //类似上 
        "sourceName":"评论来源",     //评论来源
        "sourceLink":"http://xx.com/dd.html"    //来源链接
    } 

返回结果

//响应
{ 
    "success":1,    //0,failed;1:success 
    "code":"1", 
    "message":"发表成功!", 
    "data":{ 
        "time":"1280212861768",     //评论时间(长整型) 
        "id":"665521",              //评论UUID 
        "toUid":"123123",           //收到评论者id 
        "word":"",                  //评论内容 
        "wordOrigin":" ",           //未处理的评论内容 
        "userId": 123,                          //用户Id 
        "userName": "abc",                      //用户名称 
        "startype": 0,                          /*认证类型:3手机认证,2.V用户,1.企业用户,0未认证*/  
        "stardesc":"认证描述", 
        "starurl":"http://....",                    //认证URL 
    } 
} 

注意事项

天涯微博已正式启用手机认证功能,未通过手机认证的API接口将返回如下提示:

相关数据结构 {

  "result":"0",    //结果标识1为正常,0为失败  
 "data":{" "},  
  "error":   
   {  
       "亲,你需要手机认证哦!>>   //错误信息 	
   }  

}

$list = json_decode($data,true);

if(strstr($list['error'],'span'))
{
    echo $list['error'];//输出此提示给普通用户,连接到手机认证进行认证
}//后期result的CODE可能会变化,开发者可根据接口变化进行捕捉,提示您的用户

PHP示例

请从SDK下载处下载PHP SDK(支持OAuth验证之版本)

代码示例如下: 
include 'tyapi.php'; 
//参数设置 
$appkey=; 
$appsecret=; 
$url = 'http://open.tianya.cn/api/weibo/insertretweet.php';
$params['actId'] = 123; 
…
$data = do_post($url,$appkey,$appsecret,$_SESSION["oauth_token"],$_SESSION["oauth_token_secret"],$ params);

查看
个人工具
成功案例
帮助中心