Upload API

The main functionality of our public Upload API is to upload an annotation to a website on which you have write access.

Info: Write access is defined to the website secret, which you can obtain by logging in to your semantify.it account.

Make a POST request here: https://semantify.it/api/annotation/{websiteUid} with your annotation in the body and website-secret in the header.

Example:

HTTP POST https://semantify.it/api/annotation/B1RUA-3Hb

REQUEST BODY:

{
  "content": {
    "@context": "http://schema.org/",
    "@type": "Blog",
    "url": "http://test.com/test.html",
    "name": "Test Blog Article",
    "position": "one"
  },
  "name": "Test Annotation Name",
  "cid": "test-000-cid",
  "domainSpecification": "591e327ff918632853a4945e"
}

RESPONSE BODY:

{
  "_id": "59079ccd6a350000b8aa98b2",
  "name": "Test Annotation Name",
  "domainSpecification": "null",
  "type": [
    "Blog"
  ],
  "UID": "SkUC3zr1-",
  "CID": "null",
  "enc_url": "http%3A%2F%2Ftest.com%2Ftest.html",
  "updated": "2017-08-03T21:47:08.902Z",
  "created": "2017-07-19T01:11:24.078Z",
  "content": {
    "@context": "http://schema.org/",
    "@type": "Blog",
    "url": "http://test.com/test.html",
    "name": "Test Blog Article",
    "position": "one"
  }
}

Check our API Documentation for more detail.