Profile.setMYML
出自Manyou开发者指南
目录 |
描述
设置用户个人主页中显示的 MYML ,包括个人主页中的应用程序块和行为列表。关于应用范围和在不同场合的用法,请参考 MYML 文档。请注意本方法同样可以用来设置用户行为 my:profile-action。
为了保证执行速度,应用通过此接口设置的 MYML 代码,将被 MYOP 及 UCenter Home 所缓存。如需更新这些内容,请在画布页面、或使用诸如计划任务 (Cron) 之类的脚本调用 profile.setMYML。
开发者必须传递应用所代表的用户 ID 或这个应用当前的 Session Key(二选一),如果未指定用户的 uid,则将使用当前登陆的用户。
参数
| 必选性 | 参数名 | 类型 | 描述 | |
| required | 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 的用户的UID,如果没有指定此参数将使用当前用户 |
请求范例
| 本例使用的是 PHP 客户端: // 实例化Manyou类库 $manyou = new Manyou($api_key, $api_secret); $manyou->api_client->profile_setMYML('hello myml'); |
JSON返回结果范例
| "true" |
错误代码
| 错误代码 | 描述 | |
| 1 | 发生了一个未知错误,请重新提交请求。 | |
|---|---|---|
| 2 | 目前服务不可用。 | |
| 3 | 未知的方法名称。 | |
| 4 | 应用请求已达到最大允许请求次数。 | |
| 5 | IP 地址被禁止。 | |
| 100 | 无效的参数。 | |
| 101 | 无效的 API Key。 | |
| 102 | 无效或已超时的 Session Key。请将用户引导至登陆页面以获得一个新的 Session Key。 | |
| 104 | 应用请求已达到最大允许请求次数。 | |
| 240 | 桌面应用不能指定 UID 参数。 | |
| 330 | 无效的标签。 |
