Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Make clear that all API's are JSON/HTTP #1

Closed
hbcheng opened this issue May 15, 2015 · 3 comments
Closed

Make clear that all API's are JSON/HTTP #1

hbcheng opened this issue May 15, 2015 · 3 comments
Assignees

Comments

@hbcheng
Copy link

hbcheng commented May 15, 2015

Tag @matthieu, @Catheryne for discussion:

I think the language can/should be tweaked so that it's more clear that we support any language that can make JSON HTTP calls (every modern language), and that the API is just JSON over http.

For me, this is most prominent in two places:

  1. "Official" language support: maybe weaken this, we don't want to make it seem like other languages aren't going to work for some reason. My suggestion: change to "BlockCypher Supported Language SDKs" or "Officially Supported Language SDKs" to make it clear that the support is for the language library, not the language itself. Maybe additionally, make it explicit that we support any language that can make HTTP calls and parse JSON.

  2. Frequent use of "cURL" : to experienced readers, curl is more or less a synonym for "GET over HTTP", but for inexperienced readers this may seem like some magic tool and the connection may not be obvious.

For example:

If not, or you’d rather write your own bindings, we always support cURLing endpoints directly, which is the default code sample you’ll see to the right.

My suggestion would be something along the lines of:

Of course, all our API's are standard HTTP endpoints using JSON formatted responses, so any language (or cURL from the command-line) will work just fine.
@acityinohio acityinohio self-assigned this May 15, 2015
@acityinohio
Copy link

Great feedback @hbcheng, many thanks. Both 1) and 2) make sense to change immediately (will do that now). I'll keep this issue open for now, and once I've got the skeleton done for the rest of the documentation, I'll modify the language in the introduction to make it clearer that the API is just JSON over HTTP.

@hbcheng
Copy link
Author

hbcheng commented May 15, 2015

Thanks! And great work so far, it's really shaping up nicely.

@acityinohio
Copy link

Closing this out for now Bryan---think I did a decent job making this explicitly clear for the rest of the docs, but if you think it can be sharpened up let me know by re-opening and I'll take another pass at it.

This issue was closed.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants