summaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorMatt Ranostay <matt.ranostay@konsulko.com>2019-06-14 17:56:41 -0700
committerMatt Ranostay <matt.ranostay@konsulko.com>2019-06-19 08:53:00 -0700
commit30b84ed96f8fc03fc5a73bbe97a86d76899ab8cc (patch)
tree3967da514a77ba4f1c4e186111ef44bc1197d2f3 /README.md
parenta9584f072945bfda5d7741d43cb870dcb291fd70 (diff)
binding: bluetooth-map: add message access support
Add support for retrieving messages, and listing handles of messages located in folders. SPEC-2512 Change-Id: Ia345488b51f5cac1e1c2fd508305d7ffda794251 Signed-off-by: Matt Ranostay <matt.ranostay@konsulko.com>
Diffstat (limited to 'README.md')
-rw-r--r--README.md67
1 files changed, 65 insertions, 2 deletions
diff --git a/README.md b/README.md
index 3d4d92b..d51e00e 100644
--- a/README.md
+++ b/README.md
@@ -7,14 +7,16 @@ to enable message notifications from SMS/email/etc.
### Important Notes
-Message composition isn't available on iOS devices due to respective security polices, and in
-turn isn't supported in Apple's implementation of the (MAP) Message Access Profile.
+Message composition and message access isn't available on iOS devices due to respective security
+polices, and in turn isn't supported in Apple's implementation of the (MAP) Message Access Profile.
## Verbs
| Name | Description | JSON Response |
|-------------------|------------------------------------------|-------------------------------------------|
| compose | send message | see **compose verb** section |
+| message | display message | see **message verb** section |
+| list_messages | list messages in folder | see **list_messages** section |
| subscribe | subscribe to MAP service events | *Request:* {"value": "notification"} |
| unsubscribe | unsubscribe to MAP service events | *Request:* {"value": "notification"} |
@@ -36,6 +38,67 @@ Send a message (if supported) via MAP profile:
}
</pre>
+### message verb
+
+Request a message via the respective handle:
+
+<pre>
+{
+ "handle": "message288230376151711769"
+}
+</pre>
+
+Response:
+
+<pre>
+{
+ "response": {
+ "status": "UNREAD",
+ "type": "SMS_GSM",
+ "folder": "telecom/msg/INBOX",
+ "sender": {
+ "tel": "+13605551212"
+ },
+ "message": "Meet at Victor 23 at 6p?"
+},
+
+</pre>
+
+### list_messages verb
+
+Request a folder listing of messages:
+
+<pre>
+{
+ "folder":"INBOX"
+}
+</pre>
+
+Response which the message handle as the key and includes its properties:
+
+<pre>
+{
+ "response": {
+ "message288230376151711769": {
+ "folder": "/telecom/msg/INBOX",
+ "subject": "Meet at Victor 23 at 6p?",
+ "timestamp": "20190614T093341",
+ "sender": "",
+ "senderaddress": "+13605551212",
+ "recipient": "",
+ "recipientaddress": "",
+ "type": "sms-gsm",
+ "size": 24,
+ "status": "complete",
+ "priority": false,
+ "read": false,
+ "sent": false,
+ "protected": false
+ },
+ ...
+},
+</pre>
+
### notification event
<pre>