OkayAPI Docs
API Params
| Parameter | Type | Required | Default | Note | Description |
|---|---|---|---|---|---|
| HTTP_APPKEY | String | Required | MIN: 32 | Common Put Your APPKEY | |
| file | file | Required | MAX: 2097152;Range: image/vnd.microsoft.icon/image/x-icon/image/jpg/image/jpeg/image/png/image/gif/image/bmp/application/octet-stream | 待上传的图片文件,最大2M。上传的文件,不需要纳入签名。此文件参数需要客户端通过表单方式提交。暂不支持在线测试。 | |
| file_type | String | Optaion | MAX: 80 | 文件分类,为空时取当前文件类型,可用于日后的文件整理和查询。例如:file_type=image/jpg,或:file=user。修改文件分类不会影响文件使用。 | |
| upload_full_file_path | String | Optaion | 【仅限使用自己的七牛CDN时生效】用于指定上传图片文件的完整路径,支持目录设置和原始的文件名,例如:upload_full_file_path=images/123.jpg。为空时由系统自动生成随机文件名 |
API Debug
| KEY | REQUIRED | VALUE |
|---|---|---|
| app_key | *Required | |
| file | *Required | |
| file_type | Option | |
| upload_full_file_path | Option |
API Response
| KEY | Type | Description |
|---|---|---|
| err_code | Int | 操作状态码,0成功,1失败 |
| err_msg | String | 错误提示信息,err_code非0时参考此提示信息 |
| url | String | 成功上传时返回的图片URL,失败时为空 |
| https_url | String | 成功上传时返回的HTTPS图片URL,失败或不支持HTTPS时为空 |
| id | String | 成功上传时返回的文件ID,失败时为空 |
HTTP Response Code
| HTTP Status Code | Description |
|---|---|
| Http Status = 200 | Success |
| Http Status = 400 | Illegal-Params |
| Http Status = 401 | Illegal-Token |
| Http Status = 402 | IP-Banned |
| Http Status = 404 | API-NOT-Exsits |
| Http Status = 406 | Illegal-APPKEY |
| Http Status = 407 | APPKEY-Expired-Out |
| Http Status = 408 | APPKEY-Busy |
| Http Status = 409 | Illegal-Sign |
| Http Status = 413 | API-Traffic-NOT-Enough |
| Http Status = 415 | API-LOCKED |
| Http Status = 500 | Internal-Server-Error |