HTTP接口说明

答题(上传)

上传题目图片返回结果.

请求URL

http://api.ysdm.net/create.json(扩展名支持.txt|.xml)

支持格式

txt,xml,json

HTTP请求方式

POST

请求参数
  必选 类型 说明
username true string 用户名。
password true string 用户密码。(支持32位MD5)
typeid true int 题目类型
timeout false int 任务超时时间,默认与最小值为60秒。
softid true int 软件ID,开发者可自行申请。
softkey true string 软件KEY,开发者可自行申请。
image true byte 题目截图或原始图二进制数据。
注意事项

1.开发时需要修改HTTP请求默认超时时间,具体数值需要大于任务超时的timeout参数。

2.特殊题如:中文、选择、类型较难完成的请把任务超时(timeout参数)设置大于100秒,以便满足云速任务重新分配机制。

3.网络环境中HTTP劫持会影响使用结果。

4.任务执行中切勿断拨或切断网络,否则无法接收结果。

5.POST上传请求包括图片上传格式为标准multipart/form-data编码方式,HTTP RFC1867协议

返回结果

正确返回

JSON:{"Result":"答题结果","Id":"题目Id(报错使用)"}

错误返回

JSON:{"Error":"错误提示信息","Error_Code":"","Request":""}

开发建议

推荐各开发者使用XML或者JSON方式为数据返回,为了代码运行更加健壮数据返回后先判断Result和Id两个分支是否存在,如果返回数据没有这两个分支就完全可以当错误返回处理。

答题(URL)

答题(URL)

返回请求URL的结果.

此接口只是为某种特殊情况提供方便,但请慎用,因为大多数情况下图像不同会话请求结果也会不同.

请求URL

http://api.ysdm.net/create.json(扩展名支持.txt|.xml)

支持格式

txt,xml,json

HTTP请求方式

POST

请求参数
  必选 类型 说明
username true string 用户名。
password true string 用户密码。(支持32位MD5)
typeid true int 题目类型
timeout false int 任务超时时间,默认与最小值为60秒。
softid true int 软件ID,开发者可自行申请。
softkey true string 软件KEY,开发者可自行申请。
imageurl true string 验证码图片地址。
注意事项

1.网络环境中HTTP劫持会影响使用结果。

2.任务执行中切勿断拨或切断网络,否则无法接收结果。

3.此POST请求包括图片上传所以格式为标准HTTP RFC1867协议

返回结果

{"Result":"答题结果","Id":"题目Id(报错使用)"}

错题报错

错题报错

答题结果错误报告

请求URL

http://api.ysdm.net/reporterror.json(扩展名支持.txt|.xml)

支持格式

txt,xml,json

HTTP请求方式

POST

请求参数
  必选 类型 说明
username true string 用户名。
password true string 用户密码。(支持32位MD5)
softid true int 软件ID,开发者可自行申请。
softkey true string 软件KEY,开发者可自行申请。
id true guid 报错题目的ID
注意事项

网络环境中HTTP劫持会影响使用结果。

返回结果

正确返回

JSON:{"Result":"报错成功/报错成功2"}

xml格式:

< ?xml version="1.0" ?>
< Root>
< Result>报错成功/报错成功2< /Result>
< /Root>

错误返回

JSON:{"Error":"错误提示信息","Error_Code":"错误代码(详情见错误代码表)","Request":""}

xml格式:

< ?xml version="1.0" ?>
< Root>
< Error>错误提示信息.< /Error>
< Error_Code>错误代码(详情见错误代码表)< /Error_Code>
< Request>< /Request> < /Root>

查询

查询

查询用户信息

请求URL

http://api.ysdm.net/info.json(扩展名支持.txt|.xml)

支持格式

txt,xml,json

HTTP请求方式

POST

请求参数
  必选 类型 说明
username true string 用户名。
password true string 用户密码。(支持32位MD5)
注意事项

网络环境中HTTP劫持会影响使用结果。 任务执行中切勿断拨或切断网络,否则无法接收结果。

返回结果

JSON:{"Score":"剩余点数","HistoryScore":"历史使用点数","TotalTopic":"答题总数"}

注册

注册

注册答题帐号

请求UR

http://api.ysdm.net/register.json(扩展名支持.txt|.xml)

支持格式

txt,xml,json

HTTP请求方式

POST

请求参数
  必选 类型 说明
username true string 用户名。
password true string 用户密码。
email true string 邮箱
注意事项

网络环境中HTTP劫持会影响使用结果。 任务执行中切勿断拨或切断网络,否则无法接收结果。

返回结果

{"Result":"注册成功"}

充值

充值

用户充值

请求URL

http://api.ysdm.net/recharge.json(扩展名支持.txt|.xml)

支持格式

txt,xml,json

HTTP请求方式

POST

请求参数
  必选 类型 说明
username true string 要充值的用户名。
id true guid 充值卡号。
password true string 充值卡密码
注意事项

网络环境中HTTP劫持会影响使用结果。 任务执行中切勿断拨或切断网络,否则无法接收结果。

返回结果

{"Result":"充值结果"}