OkayAPI Docs


API Path: /api/App/CDN/UploadImg

API Description: 上传 通过表单方式上传图片。如有需要,也可以使用二制流application/octet-stream格式上传。上传后,可以在小白平台-数据-素材库查看已上传的图片文件。推荐优先使用App.CDN.UploadImgByBase64接口上传。

5
API Traffic
HTTP/HTTPS
Protocol
GET/POST
Method
UTF-8
Charset
JSON
Response

API Debug   


API Params

ParameterTypeRequiredDefaultNoteDescription
HTTP_APPKEYStringRequiredMIN: 32Common Put Your APPKEY
filefileRequiredMAX: 2097152;Range: image/vnd.microsoft.icon/image/x-icon/image/jpg/image/jpeg/image/png/image/gif/image/bmp/application/octet-stream待上传的图片文件,最大2M。上传的文件,不需要纳入签名。此文件参数需要客户端通过表单方式提交。暂不支持在线测试。
file_typeStringOptaionMAX: 80文件分类,为空时取当前文件类型,可用于日后的文件整理和查询。例如:file_type=image/jpg,或:file=user。修改文件分类不会影响文件使用。
upload_full_file_pathStringOptaion【仅限使用自己的七牛CDN时生效】用于指定上传图片文件的完整路径,支持目录设置和原始的文件名,例如:upload_full_file_path=images/123.jpg。为空时由系统自动生成随机文件名

API Debug

KEYREQUIREDVALUE
app_key *Required
file *Required
file_type Option
upload_full_file_path Option

API Response

KEYTypeDescription
err_codeInt操作状态码,0成功,1失败
err_msgString错误提示信息,err_code非0时参考此提示信息
urlString成功上传时返回的图片URL,失败时为空
https_urlString成功上传时返回的HTTPS图片URL,失败或不支持HTTPS时为空
idString成功上传时返回的文件ID,失败时为空

HTTP Response Code

HTTP Status CodeDescription
Http Status = 200Success
Http Status = 400Illegal-Params
Http Status = 401Illegal-Token
Http Status = 402IP-Banned
Http Status = 404API-NOT-Exsits
Http Status = 406Illegal-APPKEY
Http Status = 407APPKEY-Expired-Out
Http Status = 408APPKEY-Busy
Http Status = 409Illegal-Sign
Http Status = 413API-Traffic-NOT-Enough
Http Status = 415API-LOCKED
Http Status = 500Internal-Server-Error