http: It's too hard to POST JSON

[josephjclark]

It took me like 5 minutes to post a JSON object to a server with HTTP post.

It shouldn't be so hard!

Where I went wrong is:

• The signature is `post(path, params, callback).
• Params should be called options , because 'we not defining URL query params
• The body goes in params.body. Why not post(path, body, options) ?
• I have to specify a content type application.json. Why doesn't the adaptor do this for me?

To be fair we do document the content type thing:

I don't remember why we don't auto-parse an object 🤔 Feels like the natural thing to do. We should log to say we're doing it, and handle errors well.

I suggest:

• Rename params to options
• Either auto-detect content type, or just default to json, unless the content-type header is set
• Update the signature when we do our next major version bump

[aleksa-krolls]

@hunterachieng adding new issues to your Ready backlog. Please add estimates before getting started, and sync with Joe if you need to align on the approach.