开发文档 - 滴滴答题

开发文档

接口文档

登录(GET)

GET http://api.dididati.com/v3/user/login
//参数
username String 用户名
password String 密码

//举例
GET http://api.dididati.com/v3/user/login?username=13588888888&password=123456

//返回结果
正确:
返回用户key,格式如下
{
    "err": "0",
    "result": {
        "userkey": "ABCDEF1234567890082347923163678432"
    }
}

错误:
返回json格式错误说明

上传题图(POST):表单形式

POST http://api.dididati.com/v3/upload
//参数编码
Content-Type: multipart/form-data
//参数
image File 图片文件
userkey String 用户登录成功后的返回的userkey
appkey String 软件Key [选填] 默认使用系统appkey, 积分10分, 可在后台软件管理自己生成.
type String 题型 [选填] 默认为8001, 英数混合题
prompt String 提示信息 [选填]

//返回结果
正确:
返回结果,格式如下
{
    "err":"0",
    "result":{
        "code":"fdkz",
        "id":"5c0984c9-aa9a-4083-9e90-accce311c46d"
    }
}

错误:
返回json格式错误说明

封包举例

POST /v3/upload HTTP/1.1
Accept: */*
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.8; rv:24.0) Gecko/20100101 Firefox/24.0
Host: api.dididati.com:80
Accept-Encoding: gzip, deflate
Content-Type: multipart/form-data; boundary=48940923NODERESLTER3890457293
Connection: close

--48940923NODERESLTER3890457293
Content-Disposition: form-data; name="userkey"

用户登录接口返回的userkey
--48940923NODERESLTER3890457293
Content-Disposition: form-data; name="appkey"

后台获取的软件appkey
--48940923NODERESLTER3890457293
Content-Disposition: form-data; name="image"; filename="1.jpg"
Content-Type: application/octet-stream

图片字节内容
--48940923NODERESLTER3890457293--

上传题图(POST):Base64格式,支持ajax

POST http://api.dididati.com/v3/upload/base64
//参数编码
Content-Type: application/x-www-form-urlencoded
//参数
image String 图片编码为Base64字符串格式(必须使用url编码,否则识别会有问题)
userkey String 用户登录成功后返回的userkey
appkey String 软件Key [选填] 默认使用系统app, 积分10分
type String 题型 [选填] 默认为8001, 英数混合题

//返回结果
正确:
返回结果,格式如下
{
    "err":"0",
    "result":{
        "code":"fdkz",
        "id":"5c0984c9-aa9a-4083-9e90-accce311c46d" 
    }
}

错误:
返回json格式错误说明

结果报错(GET)

GET http://api.dididati.com/v3/report
//参数
userkey String 用户登录成功后的key
id String 上传题图(upload接口)返回的id

//举例
GET http://api.dididati.com/v3/report?userkey=xxx&id=XXXX-XXXX-XXX

//返回结果
正确:
{
    "err":"0"
}

错误:
返回json格式错误说明

查询用户信息(GET)

GET http://api.dididati.com/v3/user/info
//参数
userkey String 用户登录成功后的key

//举例
GET http://api.dididati.com/v3/user/info?userkey=xxx

//返回结果
正确:
返回积分结果
{
    "err": "0",
    "result": {
        "points": "12000"
    }
}

错误:
返回json格式错误说明

错误代码说明

格式

{
  "err":"错误码",
  "msg":"错误信息"
}

300, 缺少参数.

301, userkey无效, 用户未登录.

302, appkey无效.

303, image参数缺少

304, 文件格式无效.

305, 文件过大, 最大支持文件100k.

500, 内部错误, 请联系客服.

501, 内部错误, 请联系客服.

503, 内部错误, 请联系客服.

507, 内部错误, 请联系客服.

601, 登录失败,更多错误信息请参考msg字段

602, 报错失败,更多错误信息请参考msg字段

603, 积分获取失败,更多错误信息请参考msg字段

604, 扣费失败,更多错误信息请参考msg字段

605, 无法识别