Repository files navigation

jsonbin.org - A personal JSON store as a RESTful service

curlhttps://jsonbin.org/remy/blog

To save data, you'll first need tosign in to get an API key.

jsonbin.org is a personal key/value JSON store as a service. Protected behind authentication and API key requests, data is stored as JSON and can be deep linked. A permissioning model also allows specific paths to your store to become public to share with others.

The aim of the project is to provide a simplified data store for tinkerers.

Important: jsonbin is currently in open beta. If you have questions, please getin touch.

By default all user store data is protected behind auth either via browser sign in, or anauthorization token. The token is yourapikey. For example:

curl -X POST https://jsonbin.org/remy/blog \     -H 'Authorization: token abcd-xyz-123' \     -d '{ url: "https://remysharp.com" }'

A private namespace URL "_" is used for jsonbin specific endpoints:

• /_/help This page.
• /_/login Auth with github.
• /_/logout Clear your session.
• /_/me Your full profile.
• /_/me/apikey Your API key.
• /_/me/apikey DELETE to revoke your current key.
• /_/me/username Your username.
• /_/me/public Your public paths.
• /_/me/:path Deep link to profile properties.

The following methods with yourauthorization header will access your data store againsthttps://jsonbin.org/:username/:

• GET return given path mapped to a JSON path.
• POST store the payload (supports JSON and files).
• PATCH merge the payload with the endpoint.
• DELETE store path.

By default all endpoints are private, but you can modify a specific entry point to be public by default by changing the permissions:

• PUT/:username/:path/_perms make the:path public.
• DELETE/:username/:path/_perms make:path private.
• GET/:username/:path/_perms check permissions of:path.

Public endpoints acceptGET requests without theauthorization header.

You can use jsonbin as a shared clipboard across machines. Creating an alias to uploadSTDIN viacurl could be posted to a public URL:

alias jsonbin="curl -X 'POST' \      -H'authorization: token abcd-xyz-123' \      -F'content=@-' \      https://jsonbin.org/remy/clipboard"echo "foo" | jsonbin

This project lives atgithub/jsonbin. Please report bugs togithub/jsonbin/issues.

Remy Sharp <remy@leftlogic.com>

MIT