短信平台API说明书.docVIP

短信平台API说明书 Version1.2 一、主要接口函数： 1、查询短信： 设置接收到的短信状态，inMessage是接收到的某条短信，函数返回这条短信是否已经被处理了 void setHandled(Sms inMessage); 查询未处理的短信，返回接收到的未进行处理的短信列表 List findUnhandledMessage(); 查询某个时间段内的短信，startDate是起始时间，endDate是结束时间，返回的是在这个时间段内的所有短信，包括接收到的短信和发送出去的短信。 List findMessageByTime(Date startDate, Date endDate); 查询某个时间段内的短信，startDate是起始时间，endDate是结束时间，返回的是在这个时间段内接收到的所有短信，包括已处理的和未处理的。 List findInMessageByTime(Date startDate, Date endDate); 查询某个时间段内的短信，startDate是起始时间，endDate是结束时间，返回的是在这个时间段内接收到的所有短信，包括已分发的和未分发的。 List findOutMessageByTime(Date startDate, Date endDate); 查询指定号码对应的短信，可以查询指定号码在接收到的短信中作为发送者的短信和在发送的短信中作为接收者的短信，这些短信都没有状态的限定，将所有对应的短信都列出来；参数number是一个String类型，表示指定号码。 List findMessageByNumber(String number); 在接收队列中查询指定号码对应的短信。 List findInMessageByNumber(String number); 在发送队列中查询指定号码对应的短信。 List findOutMessageByNumber(String number); 在发送队列中查询未进行分发的短信。 List findUndispatchedMessage(); 2、发送短信： 发送短信，返回短信是否发送成功的报告，用于单发；number是待接收短信的号码列表， context是短信内容。发送完毕后短信立即从数据库中自动删除，不再保留。 void sendMessage(String number, String context); 发送短信，功能和上述类似，用于群发；numbers是待接收短信的号码列表。 void sendMessages(List numbers, String context); 发送短信，功能和上述类似，用于单发，validityPeriod是短信在数据库中要保留的有效期，从将短信分发出去时算起，默认是10天；有效期后，短信自动从数据库中删除。 void sendMessage(String number, String context, int validityPeriod); 发送短信，功能和上述类似，用于群发；numbers是待接收短信的号码列表。 void sendMessages(List numbers, String context, int validityPeriod); 设置定时发送短信，可以在timeToSend指定的日期时间发送短信。 void sendMessage(String number, String context, Date timeToSend); 设置定时发送短信，功能和上述类似，numbers是待接收短信的号码列表。 void sendMessages(List numbers, String context, Date timeToSend); 设置定时发送短信，功能和上述类似，validityPeriod是短信在数据库中保留的有效期。 void sendMessage(String number, String context, Date timeToSend, int validityPeriod); 设置定时发送短信，功能和上述类似，numbers是待接收短信的号码列表。 void sendMessages(List numbers, String context, Date timeToSend, int validityPeriod); 3、删除短信： 删除某条短信，可能是收到的也可能是发送的，用于手动删除。 void deleteMessage(Sms sm); 删除某个时间段内的所有短信，startDate是起始时间，endDate是结束时间，返回短信是否成功删除的报告。 boolean deleteMessagesByTime(Date startDate, Da