请选择 进入手机版 | 继续访问电脑版
查看: 348|回复: 3

这 Api 文档写的真够垃圾的

[复制链接]

1

主题

1

帖子

8

积分

云客

Rank: 1

积分
8
发表于 2019-5-22 18:03:50 | 显示全部楼层 |阅读模式
网易云信的 API 文档写的真的够可以的,一点严谨性都没,看了半天,被文档坑的不行不行的。
  1. POST  /receiveMsg.action   HTTP/1.1
  2. Host:  yunxinservice.com.cn
  3. Content-Type:  application/json
  4. CurTime: 1440570500855    //当前UTC时间戳,从1970年1月1日0点0 分0 秒开始到现在的毫秒数(String)
  5. MD5: feec2cda404d7417b8b427e95748bb56     //根据请求中的request body计算出来的MD5值
  6. CheckSum: 001511b8435e0b28044ca50a78e8f983026c5e01

  7. {"attach":"thisisattach","body":"hello","convType":"PERSON","eventType":"1","fromAccount":"111","fromClientType":"IOS","fromDeviceId":"thisisfromdeviceid","fromNick":"mike","msgTimestamp":"1441977355557","msgType":"TEXT","msgidClient":"1234567","msgidServer":"3456789","resendFlag":"0","to":"222"}
复制代码

  1. POST  /receiveMsg.action   HTTP/1.1
  2. Host:  yunxinservice.com.cn
  3. Content-Type:  application/json
  4. CurTime: 1440570500855    //当前UTC时间戳,从1970年1月1日0点0 分0 秒开始到现在的毫秒数(String)
  5. MD5: feec2cda404d7417b8b427e95748bb56     //根据请求中的request body计算出来的MD5值
  6. CheckSum: 001511b8435e0b28044ca50a78e8f983026c5e01

  7. {"accid":"test","clientIp":"192.168.1.100","clientType":"PC","code":"200","eventType":"2","sdkVersion":"18","timestamp":"1452504942126"}
复制代码
这 MD5值就瞎计算的,就直接贴上来了,找了个例子,计算出来的完全不一样,最后才发现,完全是复制粘贴的。


消息格式:
  1. {
  2.     "from":"test1",
  3.     "ope":0,
  4.     "to":"test2",
  5.     "type":0,//文本消息类型
  6.     "body":{
  7.     "msg":"哈哈哈"//消息内容
  8. }
  9. }
复制代码
发送请求的时候:
  1. curl -X POST -H "AppKey: go9dnk49bkd9jd9vmel1kglw0803mgq3" -H "Nonce: 4tgggergigwow323t23t" -H "CurTime: 1443592222" -H "CheckSum: 9e9db3b6c9abb2e1962cf3e6f7316fcc55583f86" -H "Content-Type: application/x-www-form-urlencoded" -d 'from=zhangsan&ope=0&to=lisi&type=0&body={"msg":"hello"}' 'https://api.netease.im/nimserver/msg/sendMsg.action'
复制代码
我去,你能告诉我,这个请求和你写的消息格式有毛线关系,你的消息格式就是,你们写文档都不带看的么?
  1. {"msg": "哈哈哈"}
复制代码


纯粹吐槽~~!无关质量,纯粹文档吐槽。
回复

使用道具 举报

0

主题

38

帖子

281

积分

管理员

Rank: 9Rank: 9Rank: 9

积分
281
发表于 2019-5-23 15:50:28 | 显示全部楼层
回复

使用道具 举报

11

主题

54

帖子

601

积分

管理员

Rank: 9Rank: 9Rank: 9

积分
601
发表于 2019-5-23 16:17:18 | 显示全部楼层
如果这两点让你觉得文档垃圾,那还真挺遗憾的。
回复

使用道具 举报

0

主题

1

帖子

4

积分

云客

Rank: 1

积分
4
发表于 2019-5-30 15:24:02 | 显示全部楼层
支持一下! 5.jpg
回复

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

快速回复 返回顶部 返回列表