OkayAPI Docs


API Path: /api/App/Captcha/Create

API Description: 生成一个新的验证码,可在小白开放平台进行相关参数配置。返回时可选择直接输出验证码图片,也可以选择返回数据。请注意,需要保管好captcha_id(直接输出图片时通过COOKIE返回),以便校验时核对。

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

API Debug   


API Params

ParameterTypeRequiredDefaultNoteDescription
HTTP_APPKEYStringRequiredMIN: 32Common Put Your APPKEY
return_formatEnumOptaionoutputRange: output/data验证码返回格式,output表示直接输出验证码图片,data表示返回base64后的验证码图片数据

API Debug

KEYREQUIREDVALUE
app_key *Required
return_format Option

API Response

KEYTypeDescription
err_codeInt操作码,0表示成功,正数表示业务失败场景,负数表示系统失败场景
err_msgString错误提示信息,err_code非0时参考此提示信息
captcha_idString验证码唯一ID,用于校验时核对(return_format=data时返回此字段)
captcha_imgString验证码图片base64后的数据(return_format=data时返回此字段)

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