The specification of different aspects of Heb12, including how various front ends should interact with back ends and what each should provide
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

1.3 KiB

API

The job of the Heb12 API is to work as a back end of sorts for when the user does not want to download a whole Bible file to use it.

/get

The /get endpoint should return data in the form of:

{
  "errors": [],
  "data": {
    "text": [
      {
        "version": "web",
        "language": "en",
        "reference": "Heb 4.12-13",
        "book": "Heb",
        "chapter": 4,
        "from": 12,
        "to": 13,
        "wholeChapter": false,
        "verses": [
          "For the word of God is living, and active, and sharper than any two-edged sword, and piercing even to the dividing of soul and spirit, of both joints and marrow, and quick to discern the thoughts and intents of the heart.",
          "There is no creature that is hidden from his sight, but all things are naked and laid open before the eyes of him with whom we have to do."
        ]
      }
    ]
  }
}

/search?words=[words seperated by spaces]

// http://api.heb12.com/search?words=for%20god%20so%20loved
{
  "error": 0,
  "verses": [
    "John 3 16"
  ]
}

Translations

/translations/json
/translations/split
/translations/xml

They can be git pulled from here:

https://github.com/heb12/gratis.json
https://github.com/gratis-bible/bible/tree/split
https://github.com/gratis-bible/bible