OkayAPI Docs


API Path: /api/App/DB_MsSQL_Data/ChangeNumber

API Description: 根据ID,修改某个字段的数值,可增加或可减少。通过在服务端进行数值的叠加,尽量保持并发下的数据一致性。

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
model_nameStringRequired数据库表名,表名规范如下:
  • 表主键:每应表必须都有一个自增主键,统一推荐为:id INT identity(1,1) NOT NULL PRIMARY KEY
  • 表名前缀:如果已经通过添加新数据库连接配置编辑数据库配置接口配置统一表前缀table_prefix,则表名参数不需要再手动添加表前缀,否则会重复。
  • 表名后缀:不能采用划线加数字为结尾的表名,因为下划线加数字的后缀会系统作为分库分表的配置而解析,如果有疑惑,请与技术客服联系。
db_markStringRequired直连数据库代号,注意!这是开发者添加的数据库代号,不是数据库的名称。使用API前请先添加新数据库连接配置
idIntRequiredMIN: 1数据ID
change_fieldStringRequired待修改数值的字段名
change_valueStringRequired待叠加的数值,正数表示相加,负数表示相减,需要传递有效数值

API Debug

KEYREQUIREDVALUE
app_key *Required
model_name *Required
db_mark *Required
id *Required
change_field *Required
change_value *Required

API Response

KEYTypeDescription
err_codeInt状态操作码,0成功;1开发类错误,修改失败(表单不存在,字段类型不是数值类型,数据不存在或已被删除)
err_msgString错误提示信息,err_code非0时参考此提示信息
change_valueString回传客户端本次待更改的数值
after_valueString本次更新后,最新的字段值

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