openapi-directory/api/bethmardutho.org.json

Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS

{"openapi":"3.0.0","info":{"contact":{"email":"sedra@bethmardutho.org"},"description":"The SEDRA API is documented in **OpenAPI format** and uses [ReDoc](https://github.com/Rebilly/ReDoc) for documentation.\n# Introduction\nThis document describes the JSON API for the Syriac Electronic Data Research Archive (SEDRA). The SEDRA project is a linguistic and literary database of Syriac language and literature focusing on providing electronic access to the corpus of Syriac lexicons with linguistic information added to each entry in those lexicons. The API is a mechanism to provide the linguistic information stored in SEDRA to a broader audience.\nAdditionally there is a XML API for Syriac words which conforms to a prototype Semitic Languages schema which can be found in the XSD file https://sedra.bethmardutho.org/api/semiticLanguages.xsd.\n# Cross-Origin Resource Sharing\nThis API features Cross-Origin Resource Sharing (CORS) implemented in compliance with the [W3C spec](https://www.w3.org/TR/cors/) and allows cross-domain communication from the browser.\nAll responses have a wildcard same-origin which makes them completely public and accessible to everyone, including any code on any site.\n# Samples\nExplaining how to lookup words in the SEDRA API is complex and would clutter the API description. For that reason we have chosen to give the explanation of how to lookup words in its own section. SEDRA can lookup words by the SEDRA word Id. However, it will often be the case that the consumer of information provided by the SEDRA API does not know the SEDRA word Id. It is for that reason that the SEDRA API provides a method to lookup words by the Syriac text. But that process is complicated by the nature of Syriac writing. So the SEDRA API will lookup words for consonantal, partially vocalized, and fully vocalized Syriac text. Using the word Id will provide the most accurate results as the exact word will be returned. Fully vocalized text will provide the next most accurate result. The least accurate results will be returned by partially vocalized and consonantal Syriac words in that order. Following are some samples to help understand how this works.\n1. By Word Id [30862](https://sedra.bethmardutho.org/api/word/30862.json)\n2. By fully vocalized Syriac word [ܐܰܒܳܪܳܐ](https://sedra.bethmardutho.org/api/word/ܐܰܒܳܪܳܐ.json)\n3. By partially vocalized Syriac word [ܐܶܒܪܐ](https://sedra.bethmardutho.org/api/word/ܐܶܒܪܐ.json)\n4. By consonantal Syriac word [ܐܒܪܐ](https://sedra.bethmardutho.org/api/word/ܐܒܪܐ.json).","license":{"name":"Apache 2.0","url":"http://www.apache.org/licenses/LICENSE-2.0.html"},"title":"SEDRA IV API","version":"1.0.0","x-logo":{"url":"https://bethmardutho.org/wp-content/uploads/2018/04/cropped-BMlogo-6-180x180.jpg"},"x-origin":[{"format":"swagger","url":"https://sedra.bethmardutho.org/api/openapi","version":"2.0"}],"x-providerName":"bethmardutho.org"},"externalDocs":{"description":"Find out how to create a Github repo for your OpenAPI spec.","url":"https://github.com/Rebilly/generator-openapi-repo"},"tags":[{"name":"API"}],"paths":{"/lexeme/{id}":{"get":{"description":"Returns linguistic information for a Syriac lexeme.","parameters":[{"description":"The Id of a lexeme from the Sedra database.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"A Syriac lexeme.","content":{"application/json":{"schema":{"properties":{"categoryType":{"description":"The category of the Syriac lexeme or word.","enum":["adjective","adjective of place","adverb","adverb ending with aiyt","denominative","idiom","noun","numeral","participle adjective","particle","pronoun","proper noun","substantive","verb","proper noun (individual's name; e.g. Ephrem)","proper noun (place name)","proper noun (nations; e.g. Huns)","demonym","preposition","interjection"],"type":"string"},"etymologies":{"$ref":"#/components/schemas/schema1"},"glosses":{"$ref":"#/components/schemas/schema1"},"kaylo":{"$ref":"#/components/schemas/schema2"},"lexeme":{"$ref":"#/components/schemas/schema3"},"root":{"$ref":"#/components/schemas/schema3"},"syriac":{"description":"Consonantal form of this Syriac lexeme.","type":"string"},"words":{"items":{"$ref":"#/components/schemas/schema3"},"type":"array"}},"required":["lexeme","syriac"],"type":"object"}}}}},"summary":"Get Syriac lexeme.","tags":["API"]}},"/word/{id}":{"get":{"description":"Returns an array of linguistic information for every word that matches the Syriac word. Adjustment is made if the Syriac word is consonantal, partially, or fully vocalized.","parameters":[{"description":"The id parameters must contain either the Id of a word from the Sedra database or a Syriac word in the unicode character set. When the id parameter is a Syriac word it may be consonantal, partially vocalized, or fully vocalized. Fully vocalized Syriac words will have less false positive results than partially vocalized or consonantal Syriac words. When id is the Id of a word from the SEDRA database then that word will be the only word in the result.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"An array of Syriac words.","content":{"application/json":{"schema":{"items":{"properties":{"eastern":{"description":"Eastern vocalized form of this Syriac word.","type":"string"},"gender":{"$ref":"#/components/schemas/schema4"},"glosses":{"$ref":"#/components/schemas/schema1"},"hasSeyame":{"description":"Indicator to the presence of a Seyame in this word.","type":"boolean"},"isEnclitic":{"description":"Indicator if this Syriac word is an enclitic.","type":"boolean"},"isLexicalForm":{"description":"Indicator if this Syriac word is the lexeme form.","type":"boolean"},"isTheoretical":{"description":"Indicator if this Syriac word is theoretical or it is attested.","type":"boolean"},"kaylo":{"$ref":"#/components/schemas/schema2"},"lexeme":{"$ref":"#/components/schemas/schema3"},"number":{"$ref":"#/components/schemas/schema5"},"person":{"$ref":"#/components/schemas/schema6"},"state":{"description":"The state of a Syriac substantive or adjective.","enum":["absolute","emphatic","construct"],"type":"string"},"suffixGender":{"$ref":"#/components/schemas/schema4"},"suffixNumber":{"$ref":"#/components/schemas/schema5"},"suffixPerson":{"$ref":"#/components/schemas/schema6"},"suffixType":{"description":"The type of suffix attached to the Syriac word.","enum":["contraction","suffix"],"type":"string"},"syriac":{"description":"Consonantal form of this Syriac word.","type":"string"},"tense":{"description":"The tense of a Syriac verb.","enum":["active participle","imperative","imperfect","infinitive","participle","passive participle","perfect"],"type":"string"},"western":{"description":"Western vocalized form of this Syriac word.","type":"string"},"word":{"$ref":"#/components/schemas/schema3"}},"required":["word","lexeme","syriac"],"type":"object"},"type":"array"}}}}},"summary":"Get Syriac word.","tags":["API"]}}},"x-tagGroups":[{"name":"","tags":["API"]}],"servers":[{"url":"http://sedra.bethmardutho.org/api"},{"url":"https://sedra.bethmardutho.org/api"}],"components":{"schemas":{"schema1":{"additionalProperties":{"items":{"type":"string"},"type":"array"},"description":"A hashmap with language name as a key and and array of text strings in that language","type":"object"},"schema2":{"description":"The Kaylo or conjugation of a Syriac verb.","enum":["ettaphʿal (pass. of Taphʿel)","IVa","IVp","pʿal","paʿʿel","shaphʿel","palpel","ethpaʿʿal","aphʿel","ettaphʿal","saphʿel","ethpʿel","p","ethp","ethpalpal","payʿel","ethpayʿal","ethparʿal","eshtaphʿal","ethpawʿal","pawʿel","palpal","pamʿel","taphʿel","parʿel","estaphʿal","ethpaʿli","paʿli"],"type":"string"},"schema3":{"description":"","properties":{"id":{"description":"The SEDRA 'Id' used for referencing this object.","type":"integer"},"uri":{"description":"Full URI of the SEDRA API reference for this object.","type":"string"}},"required":["id","uri"],"type":"object"},"schema4":{"description":"The gender of a Syriac adjective, noun, numeral, pronoun, suffix, or verb.","enum":["common","feminine","masculine"],"type":"string"},"schema5":{"description":"The number of a Syriac adjective, noun, suffix, or verb.","enum":["plural","singular"],"type":"string"},"schema6":{"description":"The person of a Syriac verb.","enum":["first","second","third"],"type":"string"}}}}