聊天记录 [环信开发文档]

   皇冠现金官网


环志维持 APP 把聊天记录经过 REST 交谈出口。

聊天记录创纪录的结构

{
    "msg_id": "5I02W-16-8278a", //音讯ID
    "timestamp": 1403099033211, 音讯发送时期
    环境判定:内向,
    "to": "1402541206787", 收件人的用户名或收执组的ID
    "from": "zw123", 发送者用户名
    "chat_type": "chat", 用于判别独唱聊天或群组聊天。chat: 单聊;groupchat: 群聊
    "payload": {
        "bodies": [ 音讯体
          {
           确切的的音讯典型,主体创纪录的体式显示在以下各节中
          }
        ],
        "ext": { 自定义扩张属性
            "key1": "value1",   设置的关键字和值的值
    		   ...
         },
         "from":"zw123",
         "to":"1402541206787"
    }
}

版本典型音讯

"bodies": [ 音讯体
   {
       谷氨酸一钠:表示问候 from test2",//音讯实质
       典型:TXT/ /版本音讯典型
   }
]

图片典型音讯

"bodies": [ 音讯体
   {
       "file_length":128827,图像附着量级(单位):八位位组)
       "filename":"", //图片规定
       "secret":"DRGM8OZrEeO1vafuJSo2IjHBeKlIhDp0GCnFu54xOF3M6KLr", 上载图片后将归还亲密的,正是亲密的才干下载图片
       上涂料:{高地〉:1325,"width":746},//图片量级
       典型:IMG,图片通讯典型
    	"url":"", 上载图片通讯地址,上载图片后,将归还UUID   
   }
]

地址使就座典型音讯

"bodies": [ 音讯体
   {
       ADDR:西西城区门大桥 ",要发送的地址
       LAT:范围
       LNG:经度 
       典型:LOC/使就座音讯典型    
   }
]

语音典型音讯

"bodies": [ 音讯体
   {
       "file_length":6630,语音衔接量级(单位):八位位组)
       "filename":"",语音规定
       大量:10, 语音时期(单位):秒)
       "secret":"DRGM8OZrEeO1vafuJSo2IjHBeKlIhDp0GCnFu54xOF3M6KLr",记录上载后会归还亲密的  
       典型:音频,语音音讯典型
    URL:/上载语音遥控器地址,发表上载后归还UUID
   }
]

录像典型音讯

"bodies": [ 音讯体
   {
       "file_length": 58103,录像附件量级(单位):八位位组)
       "filename": "",录像记录名
       "length": 10,录像回放大量
       "secret": "VfEpSmSvEeS7yU8dwa9rAQc-DIL2HhmpujTNfSTsrDt6eNb_",记录上载后会归还亲密的
       上涂料:{高地〉:480,"width":360},录像极短的量级
       "thumb": "",上载录像极短的的遥控器地址,上载录像极短的后归还UUID
       "thumb_secret": "ZyebKn9pEeSSfY03ROk7ND24zUf74s7HpPN1oMV-1JxN2O2I",上载极短的后的亲密的归还
       "type": "video",录像音讯典型
        "url": /上载录像遥控器地址,上载录像后,归还UUID    
   }
]

记录典型音讯

"bodies": [ 音讯体
   {
       "file_length":3279,记录附件上涂料(单位):八位位组)
       "filename":"",录像记录名
       "secret":"2RNXCgeeEee2caV-fSQ1btZXJH4cgr2admVXn560He2PD3RX",记录上载后会归还亲密的
       典型:记录,记录音讯典型
       URL:/上载记录遥控器地址,上载记录后归还uuID  
   }
]

导出聊天记录

导出聊天记录交谈缺陷实时交谈达到预期的目的的时期在必然的延时,不克不及用作实时拉音讯的交谈。

眼前装备两种方式来导出聊天记录,即下载历史音讯记录和TH的两个交谈。,历史音讯交谈作为旧交谈,将终止。,提议应用下载历史音讯记录交谈。

主宰以下实质 API 您必要计划管理员的用发动机发动才干叫它。。

辩论时期期限下载历史音讯记录

留意:在调动顺序中,以防归还429或503个失当,弄清范围受到限度局限。,请稍停,再发球。。交谈流限度局限的详细的视域。

  • Path: /{org_name}/{app_name}/chatmessages/${time}

  • HTTP Method: GET

  • Request Headers: {“Content-Type”:”application/json”,”Authorization”:”Bearer ${token}”}

  • Response Body: 下载历史记录地址,您可以经过地址下载有关的的历史记录。。

  • 能够的失当代码:400(历史记录已失期)、要达到预期的目的的历史创纪录的还没有发生。、401(未受权)、代币失当、代币失期、5xx。详见:

    发球者 REST API 行失当码

  • 查询时期体式为10位数字方式(YYYYMMDDHH),譬如,we的所有格形式必要在decorate 装饰从7到8反省历史记录。,你必要进入2016121007,7:00的通讯也将包住在即将到来的记录中。

  • 因历史记录封爵必要必然的时期。,提议用户在达到预期的目的棉纸时坚持一小时的更迭。,譬如,2016/12/10 09:00而且,你可以开端下载2016/12 / 10 07:00 ~ 08:00的通讯历史

  • 交谈归还的下载地址无效30分钟。

  • 服侍默许防腐处理3天的历史记录,以防您必要延伸记忆时期,请与服务经理修饰。。

Response 示例:

{
	....
	"uri" : "",
	"data" : [ {
	"url" : ""  归还记录下载地址
	....
}

curl 示例:

curl -H "Authorization: Bearer YWMtKE9FxsAVEeaakDV5WXc9dQAAAAAAAAAAAAAAAAAAAAF8W6hAc0gR5oUiCYHCfur3AgMAAAFY8Ox2UgBPGgA6gtMo9E-nU8uaqRLXcs63EZi6Iu0QBpw6vta5E8Ix-g" -X GET ""

辩论时期期限绘制历史音讯(废弃)

至多一次报酬率为1000。

留意:在调动顺序中,以防归还429或503个失当,弄清范围受到限度局限。,请稍停,再发球。。交谈流限度局限的详细的视域。

  • Path: /{org_name}/{app_name}/chatmessages

  • HTTP Method: GET

  • Request Headers: {“Content-Type”:”application/json”,”Authorization”:”Bearer ${token}”}

  • Response Body: 聊天记录(JSON),默许归还10条记录

  • 服侍默许3天的历史音讯记录,以防您必要延伸记忆时期,请与服务经理修饰。。

Response 示例:

{
	....
	"count" : 10, 进项的号码
	"cursor" : "asdsdfaee", //游标,寻呼查询
	"entities" : [
		{
		聊天记录entity
		}
		...
	]
	....
}

示例1:辩论 timestamp 查询聊天记录

在URL前面添加限制因素 ql=select * where timestamp>1403164734226 或许 ql=select * where timestamp<1403164734226。前面的限制因素必要引申义。。

  • 以防不料应用最新音讯 timestamp>1403166586000,而且记录已达到预期的目的的顶点一音讯。 timestamp,用作再收买 timestamp,用该方式停止查询。

  • 必要导出聊天记录的,可以结成 cursor 分页来查询出所必要的聊天记录。聊天记录查询交谈归还创纪录的曾经依照 timestamp 接守按升序排序。。

  • 不克不及应用 and、or 方式这种查询的相当运算符。 ql=select * where timestamp<1403164734226 and timestamp>1403166586000

curl 示例:

curl -X GET -i -H "Authorization: Bearer YWMtxc6K0L1aEeKf9LWFzT9xEAAAAT7MNR_9OcNq-GwPsKwj_TruuxZfFSC2eIQ" "*+where+timestamp>1403164734226"

示例2:获取创纪录的的分页

应用 limit 在获得限制因素后,创纪录的就执行了。,以防前面有创纪录的,将归还一空的附件 cursor 又来,应用即将到来的 cursor 你可以获得分页。

分页情况:因为先前的创纪录的归还创纪录的 cursor 持续获取下一20创纪录的。在 URL 向前面添加限制因素 cursor,QL结算单坚持静止。

(至多10分钟呼叫一分钟),每回 limit 变憔悴为1000。)

curl 示例:

curl -X GET -i -H "Authorization: Bearer YWMtxc6K0L1aEeKf9LWFzT9xEAAAAT7MNR_9OcNq-GwPsKwj_TruuxZfFSC2eIQ" "*+where+timestamp>1403164734226&limit=20&cursor=MTYxOTcyOTYyNDpnR2tBQVFNQWdHa0FCZ0ZHczBKN0F3Q0FkUUFRYUdpdkt2ZU1FZU9vNU4zVllyT2pqUUNBZFFBUWFHaXZJUGVNRWVPMjdMRWo5b0w4dEFB"

没有评论

发表评论

电子邮件地址不会被公开。 必填项已用*标注