@@ 47,8 47,8 @@ extensions) can then communicate with it via HTTP POST requests.
### Sample Invocation ###
-Every request consists of an *action*, and a set of contextual *parameters*. A simple example of a JavaScript
-application communicating with the extension is illustrated below:
+Every request consists of a JSON-encoded object containing an *action*, and a set of contextual *parameters*.
+A simple example of a JavaScript application communicating with the extension is illustrated below:
```JavaScript
function ankiInvoke(action, params={}) {
@@ 76,7 76,11 @@ ankiInvoke('version').then(response => {
### Supported Actions ###
-The following actions are currently supported:
+The following actions are currently supported.
+
+Note that the sample requests are written here as Javascript objects rather than raw JSON.
+If you are writing raw requests be sure to send valid JSON (i.e. quote all keys and strings with
+`"`, and remove any comments).
* **version**