SaltwaterC/aws2js — Issue #14: document query object format
Author: inimino
Created: 2012-01-26 23:08:47+00:00
State: open

The way that request parameters are folded into the query object used as the second argument to many of the API functions either isn't documented, or the documentation isn't easy to find.

For example, the following page describes the SendEmail action:

http://docs.amazonwebservices.com/ses/latest/APIReference/API_SendEmail.html

From that table of request parameters, it not clear how to construct the query object in the call `ses.request('SendEmail',query,callback)`.

For example, it is not clear why the following doesn't work:

```
{"Destination":{"ToAddresses":["you@example.org"]}
...
}
```

while the following does work:

```
{"Destination.ToAddresses.member.1":"you@example.org"
...
}
```

I figured it out by looking at AWS documentation samples that show the constructed request bodies, but the naive nested construction (which is also more convenient) is what I would have expected to work.