消息订阅说明

如何获取数据

1. 机构需要提供回调接口地址，来接收数据统计服务实时发送的数据（具体订阅的消息可参考数据记录项）。

2. 机构注册回调接口地址时，需要先进行测试，数据统计服务会向注册地址发送如下测试数据

    {
        "SID": 123456,
        "Cmd": "Test",  //消息类型，Int32或String
        "Msg": "Register test.",
        "SafeKey": "String", //机构认证安全密钥md5(SECRET + TimeStamp)
        "TimeStamp": 123456789    //机构认证时间戳
    }
   

1. 机构按以下内容回复成功应答后，测试通过完成。配置生效

   {
   "error_info": {       
    "errno": 1,// int类型，1表示接收方正常接收，其他码表示出错
    "error": "程序正常执行"     //此字段只作信息参考，不用来判断是否接收成功
   }
   }
   

数据推送规则

1. 实时推送POST；
2. 数据统计服务会保证接收方接收数据的可靠性，如果发送或者接收失败，会反复重试，直到成功。
3. 接收方成功接收数据后需返回如下json格式的应答，服务收到应答后，不再尝试重发。会进到下一条消息的推送。

{
  "error_info": {       
    "errno": 1,// int类型，1表示接收方正常接收，其他码表示出错
    "error": "程序正常执行"     //此字段只作信息参考，不用来判断是否接收成功
  }
}

数据记录项（以下每一列为一种类型的消息，机构可以根据需要选择订阅需要的消息类型。）

为了更好的统计教师和学生的课堂行为，EEO Hamster服务将教师和学生在教室内的行为实时记录下来，并且对这些行为分门别类。目前，我们记录了如下教室数据：

更加详细的描述，请见API文档相关章节：

• 课节内实时推送的消息
• 课节结束后推送的消息
• 机构维度推送的消息

常见问题Q&A

1. 收到回调通知，但取不到回调数据

   回调通知数据内容是以raw json的形式发送，不是以表单的形式；

   

2. 接口测试收到报错10003

   回调接口收到通知后需要回复正确的应答，此错误表明应答数据格式错误，可能不是json，或json中的字段不正确。