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 |