paraworld.friends.get
Description
取得指定用户的所有好友
Parameters
Required |
Name |
Type |
Description |
required |
uid |
string |
用户ID |
optional |
pageIndex |
int |
显示第几页的数据(以0开始的索引,每页显示20条记录) |
onlyOnline |
int |
是否是只获取在线的好友。(0:获取全部好友 1:只获取在线好友,默认值为0) |
order |
int |
排序方式。(1:注册时间 2:加入好友时间 3:用户名) |
isInverse |
int |
是否是以倒序排序。(0:不是 1:是 默认值为0) |
format |
int |
要求返回数据的格式(0:XML 1:JSON),默认值为0 |
Example Return XML
<msg xmlns="">
<pageCnt type="int">1</pageCnt>
<uids type="string">2e17917c-574e-4684-8d29-25aadb94fad9,e121b967-5579-48b2-a7d2-13a935ed144a,58a53508-3ed7-4d17-8155-0e1eff36eed9</uids>
</msg>
Example Return JSON
{"pageCnt":"2","uids":"0a3b1121-b72f-4100-9943-bf0bacf7d045,e0dba2eb-8495-4b7d-8c3c-cf76d7cc85df,2417c363-8746-418f-b741-6028df436405"}
Error Codes
当发生异常时,返回数据中会有一个“errorCode”节点,该节点记录了错误码。
0:无异常 500:未知错误 499:提供的数据不完整 498:非法的访问 497:数据不存在或已被删除 495:索引走出界限
Test Cases
Input:
{
["uid"]="6ea1ce24-bdf7-4893-a053-eb5fd2a74281",
["pageIndex"]=0,
["isInverse"]=0,
["order"]=1,
["onlyOnline"]=0,
}
Result:
Plug-in loaded: NPLWebServiceClient.dll
{
["pageCnt"]=1,
["errorCode"]=0,
["uids"]="2e17917c-574e-4684-8d29-25aadb94fad9,e121b967-5579-48b2-a7d2-13a935ed144a,58a53508-3ed7-4d17-8155-0e1eff36eed9",
}
Topic revision: r5 - 2008-12-06
- CaoYF