OkayAPI Docs


API Path: /api/App/Table/CheckCreate

API Description: CUnique Add a distinct new data record into table. That means, when the data not exist, it will be created, otherwise, no operation is performed.

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

API Debug   


API Params

ParameterTypeRequiredDefaultNoteDescription
HTTP_APPKEYStringRequiredMIN: 32Common Put Your APPKEY
model_nameStringRequiredYour table Model Name
dataArrayJSON FormatOptaion创建时的初始化数据,需要JSON编码后传递。格式:data={"字段名1":"字段值1","字段名2":"字段值2"...}。数据中的uuid将优先于model_uuid参数。JSON Parser Online
check_fieldArraySeperated with ,Required待检测的字段。注意:data数据中必须包含此字段的数据,用作检测重复的依据。多个检测字段用英文逗号分割。例如:check_field=name,age,表示同时检测名字和年龄。请留意字段类型的相等性判断,如字符串类型的字段不能在data参数中传整型参数。
model_return_dataBooleanOptaionfalse是否返回新创建或原来的数据,model_return_data=1 返回,model_return_data=0 不返回

API Debug

KEYREQUIREDVALUE
app_key *Required
model_name *Required
data Option
check_field *Required
model_return_data Option

API Response

KEYTypeDescription
err_codeInt状态操作码,0成功;1创建失败(不符合表字段要求,或表字段不存在);2应用层规则拦截,拦截后可以小白开放平台查看日记;3、数据已存在,不再创建
err_msgString错误提示信息,err_code非0时参考此提示信息
idInt新创建数据的自增ID/或原来数据的ID
dataObject新创建或原来的数据,全部字段返回。默认不返回,model_return_data=1 才返回。

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