How do I create an annotation using the h API?

[seanh]

It could be useful during testing and development to be able to easily create annotations from the command line by making calls to the h API. How can I do that?

[seanh]

You can do this in your local development, on staging or on production.

1. Go to http://localhost:5000/account/developer and create a developer token to authenticate API requests

2. Make an API request fro the command line. In this example I'm using Using HTTPie:

   $ http POST 'http://localhost:5000/api/annotations' uri=foo Authorization:'Bearer 6879-lzF***uw4'
   

   See the docs for the annotation API. uri is the only required field.

   If you want to create an annotation in a group just add the group's pubid:

   $ http POST 'http://localhost:5000/api/annotations' uri=foo group=bLw***2dL Authorization:'Bearer 6879-lzF***uw4'
   

   You could easily script this. For example to create 10,000 annotations (using fish shell:

   $ for i in (seq 1 10000)
         http POST 'http://localhost:5000/api/annotations' uri=foo group=bLw***2dL Authorization:'Bearer 6879-lzF***uw4'
     end