御风猫开放平台是御风猫社群运营者通过飞猫号为御风猫用户提供服务和信息的平台，而开放平台为开发者提供的接口则是提供服务的基础，开发者在御风猫移动端创建或绑定飞猫号后并成功进行认证后，可以通过阅读本接口文档来获得御风猫开放能力。

御风猫开放平台的账户是以御风猫用户申请注册的飞猫号账户形式存在的，许多复杂的业务场景，可以通过御风猫开放平台的能力予以多端支持，开发者需以access_token为接口调用凭据来调用接口，所有接口的调用需要先获取access_token，access_token在2小时内有效，过期需要重新获取，但每天该字段获取次数有限，开发者需自行存储，获取access_token方式详见获取Token文档。

不同的账号类型可能具备不同的开放能力权限，详细如下表：

涉及用户数据时：

（1）您的服务需要收集用户任何数据的，必须事先获得用户的明确同意，且仅应当收集为运营及功能实现目的而必要的用户数据， 同时应当告知用户相关数据收集的目的、范围及使用方式等，保障用户知情权；

（2）您收集用户的数据后，必须采取必要的保护措施，防止用户数据被盗、泄漏等；

（3）如果游帆公司认为您收集、使用用户数据的方式，可能损害用户体验，游帆公司有权要求您删除相关数据并不得再以该方式收集、使用用户数据；

（4）一旦您停止使用本服务，或游帆公司基于任何原因终止您使用本服务，您必须立即删除全部因使用本服务而获得的数据（包括各种备份）， 且不得再以任何方式进行使用。

并且，您还需遵从如下规范：

（1）请勿为任何用户自动登录到御风猫开放平台提供代理身份验证凭据；

（2）请勿提供跟踪功能，包括但不限于识别其他用户在个人主页上查看、点击等操作行为；

（3）请勿自动将浏览器窗口定向到其他网页，以及设置或发布任何违反相关法规、公序良俗、社会公德等的玩法、内容等；

（4）请勿公开表达或暗示，您与游帆公司之间存在合作关系，包括但不限于相互持股、商业往来或合作关系等，或声称游帆公司对您的认可。

完整的开发者规范和接口限制，请详见御风猫开放平台开发者接口文档，以及御风猫开放平台开发者协议。本文档是一份动态更新的文档，我们会根据新出现的问题、相关法律法规更新或产品运营的需要来对其内容进行修改并更新，制定新的规则，保证御风猫用户的体验。你应能反复查看以便获得最新信息，请定期了解更新情况。

2019-12-18 御风猫开放平台官方文档（Beta1.0）上线！

开发者需在后台进行URL、Token参数的配置。其中，URL是开发者用来接收消息和事件的接口URL，Token可由开发者可以任意填写，用作生成签名（该Token会和接口URL中包含的Token进行比对，从而验证安全性）。

开发者提交信息后，御风猫开放平台服务器将发送GET请求到填写的服务器地址URL上，开发者可以验证消息是否是来自此服务器。返回回的GET请求携带参数如下表所示：

若开发者通过检验signature对请求进行校验，可验证是否成功配置，如果signature符合预期，开发者需原样返回randomstr，之后接入方可正式生效，否则接入失败。其signature校验方法如下：将token、timestamp参数依次拼接好进行md5加密；开发者获得加密后的字符串与signature对比，标识该请求来源于御风猫开放平台。

检验signature的PHP示例代码：

code
private function checkSignature(){
    $signature = $_GET["signature"];
    $timestamp = $_GET["timestamp"];
    $token = TOKEN;
    $tmpStr = md5($token.$timestamp);
    if( $tmpStr == $signature ){
        return true;
    }else{
        return false;
    }
}

验证URL有效性成功后即接入生效，开发者填写的服务器配置URL将得到御风猫开放平台服务器推送过来的消息和事件，开发者可以依据自身业务逻辑进行响应。

access_token是御风猫开放平台API的全局唯一接口调用凭据，调用开放平台各接口时都需使用access_token。开发者需要进行妥善保存。access_token的存储至少要保留512个字符空间。access_token的有效期为2个小时，需定时刷新，重复获取将导致上次获取的access_token失效。

开放平台的API调用所需的access_token的使用及生成方式说明：

1、建议开发者使用中控服务器统一获取和刷新access_token，其他业务逻辑服务器所使用的access_token均来自于该中控服务器，不应该各自去刷新，否则容易造成冲突，导致access_token覆盖而影响业务；

2、目前access_token的有效期通过返回的expire_in来传达，目前是7200秒之内的值。中控服务器需要根据这个有效时间提前去刷新新access_token。在刷新过程中，中控服务器可对外继续输出的老access_token，此时公众平台后台会保证在5分钟内，新老access_token都可用，这保证了第三方业务的平滑过渡；

3、access_token的有效时间可能会在未来有调整，所以中控服务器不仅需要内部定时主动刷新，还需要提供被动刷新access_token的接口，这样便于业务服务器在API调用获知access_token已超时的情况下，可以触发access_token的刷新流程;

4、用户在开放平台创建应用后可以使用AppID和AppSecret调用本接口来获取access_token。AppID和AppSecret可在“御风猫开放平台-开发者”页中获得（需要帐号没有异常状态，并且开发者已经完成服务商认证）。

code
{"status":200, "access_token":"ACCESS_TOKEN","expires_in":7200}

code
{"status":201,"msg":"Invalid appid!"}

开发者取得的JSON数据包格式如下：

假如服务器无法保证在五秒内处理并回复，必须做出下述回复，这样御风猫开放平台服务器才不会对此作任何处理，并且不会发起重试：直接回复success（推荐），或者直接回复空串（指字节长度为0的空字符串，而不是JSON数据包中content字段的内容为空）。

回送JSON数据包格式如下：

code
{
"status":200,
"msg":"send job submission success",
"taskid"：群发任务号
}

语音（type:2）：2M，播放长度不超过60s，支持AMR\MP3格式

图片（type:3）: 2M，支持PNG\JPEG\JPG\GIF格式

视频（type:4）：10MB，支持MP4格式

http请求方式：POST/FORM https://op.yfcat.com/api/material/upload?access_token=ACCESS_TOKEN&type=TYPE

调用示例（使用curl命令以FORM表单方式上传图片）：

curl -F file=@material.jpg https://op.yfcat.com/api/material/upload?access_token=ACCESS_TOKEN&type=2

正常情况下会返回下述JSON数据包给开发者：

错误情况下的返回JSON数据包示例如下：

https请求方式: GET https://op.yfcat.com/api/material/get?access_token=ACCESS_TOKEN&sourceid=SOURCEID

请求示例（通过curl命令获取素材文件）:

curl -I -G "https://op.yfcat.com/api/material/get?access_token=ACCESS_TOKEN&sourceid=SOURCEID"

(1)视频类型（素材类型码type为4）返回JSON数据包示例如下：

code
{"status":200,"type":4,,"imgurl":缩略图图片链接,"imgsid":缩略图图片资源的ID，"sourceid":视频资源的ID号,"url":视频素材的存储路径地址}

(2)语音类型（素材类型码type为2）返回HTTP头如下：

code
HTTP/1.1 200 OK
Connection: close
Content-Type: voice/speex
Content-disposition: attachment; filename="SOURCE_ID.speex"
Date: Sun, 28 Jan 2019 12:40:36 GMT
Cache-Control: no-cache, must-revalidate
Content-Length: 235598
curl -G "https://op.yfcat.com/api/material/get/jssdk?access_token=ACCESS_TOKEN&sourceid=SOURCEID"

(3)图片类型（素材类型码type为3）返回HTTP头如下：

code
HTTP/1.1 200 OK
Connection: close
Content-Type: image/jpeg
Content-disposition: attachment; filename="SOURCE_ID.jpg"
Date: Sun, 28 Jan 2019 12:40:36 GMT
Cache-Control: no-cache, must-revalidate
Content-Length: 795642
curl -G "https://op.yfcat.com/api/material/get?access_token=ACCESS_TOKEN&sourceid=SOURCE_ID"

错误情况下的返回JSON数据包示例如下：

code
{"status":201,"msg":"Failed to get."}

https请求方式: POST https://op.yfcat.com/api/material/delete?access_token=ACCESS_TOKEN

正确情况下的返回JSON数据包结果如下：

code
{"status":200,"msg":"Delete successfully."}

错误情况下的返回JSON数据包示例如下：

code
{"status":201,"msg":"Invalid appid!"}
或{"status":201,"msg":"Failed to delete."}

https请求方式: GET https://op.yfcat.com/api/material/getCount?access_token=ACCESS_TOKEN

正确情况下的返回JSON数据包结果如下：

错误情况下的返回JSON数据包示例如下：

https请求方式: POST https://op.yfcat.com/api/material/getMaterial?access_token=ACCESS_TOKEN

正确情况下的返回JSON数据包结果如下：

code
{
"status":200,   
"total_count": 素材总数,
   "item": [{
       "sourceid": 素材资源ID,
       "name": 素材资源文件名称,
       "createtime": 素材资源创建时间,
       "url":素材资源的URL
   },
   //可能有多个素材
   ]
}

错误情况下的返回JSON数据包示例如下：

code
{"status":201,"msg":"System error."}

https请求方式: GET https://op.yfcat.com/api/user/get?access_token=ACCESS_TOKEN&lastid=LAST_OPENID

正确情况下的返回JSON数据包结果如下：

code
{
    "status":200,
    "total":1000,
    "count":18,
    "data":{
    "openid":["OPENID1","OPENID2"，...,"OPENID18"]},
    "nextid":"NEXT_OPENID"
}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid appid!"}

https请求方式:POST https://op.yfcat.com/api/user/info?access_token=ACCESS_TOKEN

正确时返回JSON数据包（openid为单个时）：

code
{
    
"status":200,
"follow":1, 
    "openid":"AOBRB2JLFNDOA99COJLJKJNJOD9AO2NL", 
    "nickname":"John", 
    "sex":1, 
    "city":"成都市", 
    "province":"四川省", 
    "country":"中国",
    "headimgurl":用户头像URL,
    "followtime":"2019-12-26 22:40:12",
    "unionid": "BOC83D2ELFNGO979COLJKJ6NOD9AO2CL",
    "remark": 粉丝的备注,
    "tags":[128,2],
    "followscene":1 
}

其中：follow字段表示用户是否关注:1关注0未关注（此时拉取不到其他信息）；tags字段表示开发者为该用户打上的标签ID列表；followscene字段表示关注渠道来源：1平台内容自然展示、2名片分享、3扫码、4搜索、10其他。

正确时返回JSON数据包（openid为多个时）：

code
{
"status":200,
"data": [{
"follow":1,
"openid":"AOBRB2JLFNDOA99COJLJKJNJOD9AO2NL", 
"nickname":"John", 
"sex":1,
"city":"成都市",
"province":"四川省",
"country":"中国",
"headimgurl":用户头像URL,
"followtime":"2019-12-26 22:40:12",
"unionid":"BOC83D2ELFNGO979COLJKJ6NOD9AO2CL",
"remark":粉丝的备注,
"tags":[128,2],
"followscene":1 
},{
"follow":0,
"openid": "AOBRB2JLFNDOA99COJLJKJNJOD9AO2N2"
}]
}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid appid!"}

https请求方式: POST https://op.yfcat.com/api/user/setremark?access_token=ACCESS_TOKEN

正确时返回JSON数据包（openid为单个时）：

code
{"status":200,"msg":"Set successfully!"}

正确时返回JSON数据包（openid为多个时）：

code
{
"status":200,
"msg":"Set successfully!",
"total":设置成功总数,
"faillist":"AOBRB2JLFNDOA99COJLJKJNJOD9AO2N2,BOB2JLFNDOA9FS9COJLJKJNGJ9AOY2N3"
}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid openid!"}

https请求方式: POST https://op.yfcat.com/api/user/removefollower?access_token=ACCESS_TOKEN

正确时返回JSON数据包（openid为单个时）：

code
{"status":200,"msg":"Remove successfully!"}

正确时返回JSON数据包（openid为多个时）：

code
{
"status":200,
"msg":"Remove successfully!",
"total":移除成功总数,
"faillist":"AOBRB2JLFNDOA99COJLJKJNJOD9AO2N2,BOB2JLFNDOA9FS9COJLJKJNGJ9AOY2N3"
}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid openid!"}

https请求方式: GET https://op.yfcat.com/api/user/getblacklist?access_token=ACCESS_TOKEN&lastid=LAST_OPENID

正确情况下的返回JSON数据包结果如下：

code
{
    "status":200,
    "total":1000,
    "count":18,
    "data":{
    "openid":["OPENID1","OPENID2"，...,"OPENID18"]},
    "nextid":"NEXT_OPENID"
}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid appid!"}

https请求方式: POST https://op.yfcat.com/api/user/addblacklist?access_token=ACCESS_TOKEN&opentid=OPENID

正确时返回JSON数据包（openid为单个时）：

code
{"status":200,"msg":"Add to blacklist successfully !"}

正确时返回JSON数据包（openid为多个时）：

code
{
"status":200,
"msg":"Add to blacklist successfully!",
"total":加入黑名单总数,
"faillist":"AOBRB2JLFNDOA99COJLJKJNJOD9AO2N2,BOB2JLFNDOA9FS9COJLJKJNGJ9AOY2N3"
}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid openid!"}

https请求方式: POST https://op.yfcat.com/api/user/removeblacklist?access_token=ACCESS_TOKEN&opentid=OPENID

正确时返回JSON数据包（openid为单个时）：

code
{"status":200,"msg":"Remove from blacklist successfully !"}

正确时返回JSON数据包（openid为多个时）：

code
{
"status":200,
"msg":"Remove from blacklist successfully !"
"total":移除黑名单总数,
"faillist":"AOBRB2JLFNDOA99COJLJKJNJOD9AO2N2,BOB2JLFNDOA9FS9COJLJKJNGJ9AOY2N3"
}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid openid!"}

开发者被用户关注时将在其于后台配置的消息接收接口将收到御风猫开放平台如下JSON格式的关注事件消息推送：

code
{"status":200,"to":开发者openid,"from":发送者openid,"createtime":关注时间,"type":14,"event":"follow","msgid":消息ID}

同样的，开发者在用户取消关注时将收到如下的JSON格式事件推送：

code
{"status":200,"to":开发者openid,"from":发送者openid,"createtime":取消关注时间,"type":14,"event":"cancelfollow","msgid":消息ID}

开发者收到该事件推送后需要进行相应回复（详见消息管理-消息回复部分），或者直接回复空字符串。

https请求方式: POST https://op.yfcat.com/api/analysis/userchange?access_token=ACCESS_TOKEN

正确时返回JSON数据包：

code
{
"status":200,
"data":[{
"data":"2018-06-05",
"newuser":3,
"canceluser": 0
},{
"data":"2018-06-06",
"newuser":8,
"canceluser": 1
},//更多数据
]
}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid appid!"}
或
{"status":202,"msg":"Date Error!"}

https请求方式: POST https://op.yfcat.com/api/analysis/usercount?access_token=ACCESS_TOKEN

正确时返回JSON数据包：

code
{
"status":200,
"data":[{
"data":"2018-06-05",
"totaluser":306
},{
"data":"2018-06-06",
"totaluser":312
},//更多数据
]
}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid appid!"}
或
{"status":202,"msg":"Date Error!"}

https请求方式: POST https://op.yfcat.com/api/tag/create?access_token=ACCESS_TOKEN

正确时返回JSON数据包：

code
{"status":200,"tagid":12}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid appid!"}
或
{"status":202,"msg":"Invalid tagname!"}
或
{"status":203,"msg":"The length of tagname should less than 16!"}
或
{"status":204,"msg":"You had created too many tags,and the total number of tags should be less than 128."}

https请求方式: GET https://op.yfcat.com/api/tag/get?access_token=ACCESS_TOKEN

正确时返回JSON数据包：

code
{
"status":200,
"data":[{
"tagid":8,
"tag":"成都"
},{
"tagid":9,
"tag":"工作组"
},
//更多标签
]
}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid appid!"}

https请求方式: POST https://op.yfcat.com/api/tag/update?access_token=ACCESS_TOKEN

正确时返回JSON数据包：

code
{
"status":200,
"tagid":8,
"tag":"成都市区"
}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid appid!"}
或
{"status":202,"msg":"Invalid tagname!"}
或
{"status":203,"msg":"The length of tagname should less than 16!"}

https请求方式: POST https://op.yfcat.com/api/tag/delete?access_token=ACCESS_TOKEN

正确时返回JSON数据包：

code
{"status":200}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid appid!"}
或
{"status":202,"msg":"Invalid tagid!"}

https请求方式: GET https://op.yfcat.com/api/tag/getuserlist?access_token=ACCESS_TOKEN&lastid=LAST_OPENID

正确时返回JSON数据包：

code
{
"status":200,
"total":1000,
"count":18,
"data":[{
    "openid":["OPENID1","OPENID2"，...,"OPENID18"]},
    "nextid":"NEXT_OPENID"
}]
}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid appid!"}
或
{"status":202,"msg":"Invalid tagid!"}

https请求方式: GET https://op.yfcat.com/api/tag/setusertag?access_token=ACCESS_TOKEN&lastid=LAST_OPENID

正确时返回JSON数据包：

code
{
"status":200,
"msg":"Set successfully!",
"total":设置成功总数,
"faillist":"AOBRB2JLFNDOA99COJLJKJNJOD9AO2N2,BOB2JLFNDOA9FS9COJLJKJNGJ9AOY2N3"
}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid appid!"}

https请求方式: POST https://op.yfcat.com/api/tag/cancelusertag?access_token=ACCESS_TOKEN&lastid=LAST_OPENID

正确时返回JSON数据包：

code
{
"status":200,
"msg":"Cancel successfully!",
"total":由于本次取消标签而产生影响的用户总数,
"faillist":"AOBRB2JLFNDOA99COJLJKJNJOD9AO2N2,BOB2JLFNDOA9FS9COJLJKJNGJ9AOY2N3"
}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid appid!"}

https请求方式: POST https://op.yfcat.com/api/v2/circle/create?access_token=ACCESS_TOKEN

正确时返回JSON数据包：

code
{"status":200,"msg":"Create successfully!","circleid":系统生成的该圈子ID}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid appid!"}
或
{"status":202,"msg":"Param Error!"}
或
{"status":203,"msg":"Fail to upload image!"}

https请求方式: POST https://op.yfcat.com/api/v2/circle/update?access_token=ACCESS_TOKEN

正确时返回JSON数据包：

code
{"status":200,"msg":"Update successfully!"}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid appid!"}
或
{"status":202,"msg":"Param Error!"}

https请求方式: POST https://op.yfcat.com/api/v2/circle/delete?access_token=ACCESS_TOKEN

正确时返回JSON数据包：

code
{"status":200,"msg":"Delete successfully!"}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid appid!"}
或
{"status":202,"msg":"Param Error!"}
或
{"status":203,"msg":"Deletion condition not met!"}

开发者在用户申请加入圈子时将在其于后台配置的消息接收接口将收到御风猫开放平台如下JSON格式的关注事件消息推送：

code
{"status":200,"to":开发者openid,"from":发送者openid,"createtime":申请时间,"type":14,"event":"applycircle","msgid":消息ID}

开发者在用户取消申请加入时将收到如下的JSON格式事件推送：

code
{"status":200,"to":开发者openid,"from":发送者openid,"createtime":取消申请时间,"type":14,"event":"cancelapplycircle","msgid":消息ID}

同样的，开发者在用户主动退出圈子时将收到如下的JSON格式事件推送：

code
{"status":200,"to":开发者openid,"from":发送者openid,"createtime":退出时间,"type":14,"event":"quitcircle","msgid":消息ID}

https请求方式: GET https://op.yfcat.com/api/v2/circle/querystate?access_token=ACCESS_TOKEN&circleid=CIRCLE_ID

正确时返回JSON数据包：

code
{"status":200,"msg":"Query the status of the circle successfully!",”type”:1}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid appid!"}
或
{"status":202,"msg":"Param Error!"}

https请求方式: POST https://op.yfcat.com/api/v2/circle/getcirclelist?access_token=ACCESS_TOKEN

正确时返回JSON数据包如下，其中，字段type表示查询到圈子的状态码：圈子创建后审核中（type：3） 未查询到圈子或审核未通过（type：4） 圈子解散中（type：5） 圈子已被删除或解散（type：6） 正常免费圈子（type：1） 正常付费圈子（type：2）：

code
{
"status":200,
"data":[{
"circleid":40,
"type":1,
"ismine":1
},{
"circleid":42,
"type":2,
"ismine":1
},{
"circleid":45,
"type":1,
"ismine":0
}]
}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid appid!"}

https请求方式: POST https://op.yfcat.com/api/v2/circle/getcircleinfo?access_token=ACCESS_TOKEN

正确时返回JSON数据包：

code
{
"status":200,
"imgurl":圈子封面图URL,
"circlename":圈子名称,
"description":圈子描述,
"count":18,
"openid":["OPENID1","OPENID2"，...,"OPENID18"],
"type":1,
"createtime":圈子创建时间
}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid appid!"}
或
{"status":202,"msg":"Param Error!"}

https请求方式: POST https://op.yfcat.com/api/v2/circle/getuserinfo?access_token=ACCESS_TOKEN

正确时返回JSON数据包（openid为单个时）：

code
{    
   "status":200,
   "follow":1, 
   "openid":"AOBRB2JLFNDOA99COJLJKJNJOD9AO2NL", 
   "nickname":"John", 
   "sex":1, 
   "city":"成都市", 
   "province":"四川省", 
   "country":"中国",
   "headimgurl":用户头像URL
}

正确时返回JSON数据包（openid为多个时）：

code
{
"status":200,
"data": [
{
"status":200,
"follow":1, 
"openid":"AOBRB2JLFNDOA99COJLJKJNJOD9AO2NL", 
"nickname":"John", 
"sex":1, 
"city":"成都市", 
"province":"四川省", 
"country":"中国",
"headimgurl":用户头像URL
},{
"status":200,
"follow":0, 
"openid":"BOBRB2JLFNDOA99COJLJKJNJOD9AO2NL", 
"nickname":"John", 
"sex":2, 
"city":"成都市", 
"province":"四川省", 
"country":"中国",
"headimgurl":用户头像URL
},
//更多数据
]
}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid appid!"}

https请求方式: GET https://op.yfcat.com/api/v2/circle/getfieldlist?access_token=ACCESS_TOKEN

正确时返回JSON数据包：

code
{
"status":200,
"data":[{
"fieldid":7,
"fieldtitle":"人像摄影",
"description":"记录每一个值得记录的瞬间"
},{
"fieldid":8,
"fieldtitle":"骑行",
"description":"生命在于运动"
},
//更多数据
]
}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid appid!"}

https请求方式: POST https://op.yfcat.com/api/v2/circle/getactivitylist?access_token=ACCESS_TOKEN

正确时返回JSON数据包：

code
{
"status":200,
"count":18,
"activityid":["ACTIVITYID1","ACTIVITYID2",...,"ACTIVITYID18"]
}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid appid!"}
或
{"status":202,"msg":"Param Error!"}

https请求方式: POST https://op.yfcat.com/api/v2/activity/create?access_token=ACCESS_TOKEN

正确时返回JSON数据包：

code
{"status":200,"msg":"Create successfully!","activityid":系统生成的该活动ID}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid appid!"}
或
{"status":202,"msg":"Param Error!"}

https请求方式: POST https://op.yfcat.com/api/v2/activity/update?access_token=ACCESS_TOKEN

正确时返回JSON数据包：

code
{"status":200,"msg":"Update successfully!"}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid appid!"}
或
{"status":202,"msg":"Param Error!"}

https请求方式: POST https://op.yfcat.com/api/v2/activity/delete?access_token=ACCESS_TOKEN

正确时返回JSON数据包：

code
{"status":200,"msg":"Delete successfully!"}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid appid!"}
或
{"status":202,"msg":"Param Error!"}
或
{"status":203,"msg":"Deletion condition not met!"}

开发者在用户申请加入圈子时将在其于后台配置的消息接收接口将收到御风猫开放平台如下JSON格式的关注事件消息推送：

code
{"status":200,"to":开发者openid,"from":发送者openid,"createtime":申请时间,"type":14,"event":"applyactivity","msgid":消息ID}

开发者在用户取消申请加入时将收到如下的JSON格式事件推送：

code
{"status":200,"to":开发者openid,"from":发送者openid,"createtime":取消申请时间,"type":14,"event":"cancelapplyactivity","msgid":消息ID}

同样的，开发者在用户主动退出圈子时将收到如下的JSON格式事件推送：

code
{"status":200,"to":开发者openid,"from":发送者openid,"createtime":退出时间,"type":14,"event":"quitactivity","msgid":消息ID}

https请求方式: POST https://op.yfcat.com/api/v2/activity/getactivityinfo?access_token=ACCESS_TOKEN

关于返回值的部分字段说明：type字段为御风猫系统内部定义的活动类型（常见的类型编码有1：普通活动 2：认证用户发起公开活动 3：认证企业发起公开活动）；count字段表示活动的参与总人数，openid是一个列出了参与者的openid数组，sources是一个列出了活动内容展示图URL的数组，personlimited是默认限制该次活动的人数，默认最高6人。正确时返回JSON数据包：

code
{
"status":200,
"activityid":活动ID,
"title":活动名称,
"content":活动描述,
"count":18,
"openid":["OPENID1","OPENID2"，...,"OPENID18"],
"coversource":封面图URL,
"sources":["SOURCEURL1","SOURCEURL2",...],
"personlimited":6,
"address":"四川省成都市武侯区吉泰路",
"position":"30.545341101197145,104.068774158",
"type":1,
"createtime":活动创建时间
}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid appid!"}
或
{"status":202,"msg":"Param Error!"}

https请求方式: POST https://op.yfcat.com/api/v2/activity/getuserinfo?access_token=ACCESS_TOKEN

正确时返回JSON数据包（openid为单个时）：

code
{    
"status":200,
"follow":1, 
"openid":"AOBRB2JLFNDOA99COJLJKJNJOD9AO2NL", 
"nickname":"John", 
"sex":1, 
"city":"成都市", 
"province":"四川省", 
"country":"中国",
"headimgurl":用户头像URL
}

正确时返回JSON数据包（openid为多个时）：

code
{
"status":200,
"data": [
{
"status":200,
"follow":1, 
"openid":"AOBRB2JLFNDOA99COJLJKJNJOD9AO2NL", 
"nickname":"John", 
"sex":1, 
"city":"成都市", 
"province":"四川省", 
"country":"中国",
"headimgurl":用户头像URL
},{
"status":200,
"follow":0, 
"openid":"BOBRB2JLFNDOA99COJLJKJNJOD9AO2NL", 
"nickname":"John", 
"sex":2, 
"city":"成都市", 
"province":"四川省", 
"country":"中国",
"headimgurl":用户头像URL
},
//更多数据
]
}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid appid!"}

https请求方式: POST https://op.yfcat.com/api/v2/activity/removeuser?access_token=ACCESS_TOKEN

正确时返回JSON数据包：

code
{"status":200,"msg":"Remove successfully!"}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid appid!"}

https请求方式: POST https://op.yfcat.com/api/v2/activity/getcomments?access_token=ACCESS_TOKEN

值得说明的是contentid为讨论的唯一标识ID号，而parentid字段一般为空，若不为空表示对讨论的二级讨论，该字段用于存储讨论内容的ID号，便于快速定位、找到该条讨论对应的内容；而count字段表示一共获取到的总讨论数。正确时返回JSON数据包：

code
{
"status":200,
"count":2,
"data":[{
"openid":"AOBRB2JLFNDOA99COJLJKJNJOD9AO2NL",
"contentid":讨论的ID,
"parentid":讨论的父级内容ID,
"content":对当前活动的用户讨论内容,
"createtime":评论创建时间,
“supportnum”:当前讨论的获赞数量
},{
"openid":"BOBRB2JLFNDOA99COJLJKJNJOD9AO2NL",
"contentid":讨论的ID,
"parentid":讨论的父级内容ID,
"content":对当前活动的用户讨论内容,
"createtime":评论创建时间,
“supportnum”:当前讨论的获赞数量
}]
}

错误时返回错误码等信息，JSON数据包示例如下:

code
{"status":201,"msg":"Invalid appid!"}
或
{"status":202,"msg":"Param Error!"}