add status message

Author: Helperhaps

doc/api.md

@@ -307,6 +307,16 @@ $report->getReceived('msg_id');
 $report->getReceived(['msg_id1', 'msg_id2']);
 ```
 
+#### 送达状态查询
+
+```php
+$report->getMessageStatus('msg_id0', 'rid0')
+# OR
+$report->getMessageStatus('msg_id0', ['rid0', 'rid1'])
+#OR
+$report->getMessageStatus('msg_id0', ['rid0', 'rid1'], '2017-12-21')
+```
+
 #### 获取消息统计
 
 ```php

src/JPush/ReportPayload.php

@@ -31,6 +31,19 @@ public function getReceived($msgIds) {
         return Http::get($this->client, $url);
     }
 
+    public function getMessageStatus($msgId, $rids, $data = null) {
+        $url = $this->client->makeURL('report') . ' status/message';
+        $registrationIds = is_array($rids) ? $rids : array($rids);
+        $body = [
+            'msg_id' => $msgId,
+            'registration_ids' => $registrationIds
+        ];
+        if (!is_null($data)) {
+            $body['data'] = $data;
+        }
+        return Http::post($this->client, $url, $body);
+    }
+
     public function getMessages($msgIds) {
         $queryParams = '?msg_ids=';
         if (is_array($msgIds) && !empty($msgIds)) {

src/JPush/version.php

@@ -1,4 +1,4 @@
 <?php
 namespace JPush;
 
-  const VERSION = '3.5.26';
+  const VERSION = '3.5.27';