Profile.getMYML
出自Manyou开发者指南
目录 |
描述
获取用户个人主页中当前设置的 MYML 代码(也就是您先前使用 profile.setMYML 方法在用户个人主页中设置的 MYML 代码)。关于 MYML 代码的详细信息,请查看 MYML 文档。 在您使用本方法获取用户个人主页中 MYML 代码时,请遵循 Manyou 隐私约束,否则我们将会限制您再次访问用户的个人主页。例如,当您访问的用户不是您的好友时,我们就将会做出限制。另外,当您把一个用户个人主页中的 MYML 代码发送到另一个用户个人主页中时,请遵守 Manyou 开发者服务条款。
在使用本方法时,您必须传递用户 ID 或用户 Session Key 这两个参数的其中之一,但并不是两个都传递。如果您没有指定 uid 参数,那么程序将使用当前用户。
参数
| 必选性 | 参数名 | 类型 | 描述 | |
| 必须 | api_key | string | 申请应用时生成的 API Key。 | |
|---|---|---|---|---|
| call_id | float | 请求序列值。每个请求都有一个序列值,并且后一个比前一个大,序列值和 session 无关。我们建议您使用以毫秒为单位的当前时间的值,类似 PHP 中的 microtime(true) 函数。 | ||
| sig | string | MD5 串。根据当前请求和 Secret 值加密获得。 | ||
| v | string | 本参数的值必须设置为 1.0,表示 API 的版本号。 | ||
| 可选 | session_key | string | 登录用户的 Session key。当没有指定 uid 参数时,将使用此参数。 | |
| format | string | 指定响应返回的格式。有 PHP (默认) 、 JSON 和 XML 这三种值可选。 | ||
| uid | int | 得到指定用户的个人主页的 MYML文本,如果没有指定此参数将得到当前登陆用户的个人主页 MYML。 |
请求范例
| 本例使用的是 PHP 客户端: // 实例化Manyou类库 $manyou = new Manyou($api_key, $api_secret); $manyou->api_client->profile_getMYML(); |
返回结果范例
| <my:name uid="12345" linked="true" /> |
错误代码
| 错误代码 | 描述 | |
| 1 | 发生了一个未知错误,请重新提交请求。 | |
|---|---|---|
| 2 | 目前服务不可用。 | |
| 4 | 未知的方法名称。 | |
| 5 | 应用请求已达到最大允许请求次数。 | |
| 100 | 无效的参数。 | |
| 101 | 无效的 API Key。 | |
| 102 | 无效或已超时的 Session Key。请将用户引导至登陆页面以获得一个新的 Session Key。 | |
| 104 | 无效的签名值。 |
