swagger.json

{
  "openapi": "3.0.1",
  "info": {
    "title": "Dictionary JSON API",
    "description": "This API is developed by the University of Bergen. Its purpose is to serve the new national dictionary website wich is under development. API keys are available upon request. No warranty.",
    "version": "beta"
  },
  "servers": [
    {
      "url": "/api"
    }
  ],
  "paths": {
    "/article/{dict_id}/{art_id}": {
      "get": {
        "parameters": [
          {
            "name": "dict_id",
            "in": "path",
            "required": true,
            "description": "Dictionary code, 'bob' for bokmål, 'nob' for nynorsk",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "art_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "security": [
          {
            "api_key": []
          }
        ],
        "responses": {
          "200": {
            "description": "bla bla",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/article/{dict_id}/search": {
      "summary": "Search for a word",
      "description": "Search for words as an article lemmas, or words occurring in certain article elements. For instance, old norse _fljúga_ will match the article for modern Norwegian verb _fly_ (meaning to fly)",
      "get": {
        "parameters": [
          {
            "name": "dict_id",
            "description": "Dictionary to search, 'bob' for bokmål, 'nob' for nynorsk, 'bob,bob' for both",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "q",
            "description": "Query string",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "api_key": []
          }
        ],
        "responses": {
          "200": {
            "description": "bla bla",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/article/{dict_id}/suggest": {
      "get": {
        "summary": "Get autocomplete suggestions for a prefix",
        "description": "Returns articles for words that begin with the prefix specified in query string 'q'",
        "parameters": [
          {
            "name": "dict_id",
            "description": "Dictionary to search, 'bob' for bokmål, 'nob' for nynorsk, 'bob,bob' for both",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "q",
            "description": "Query string: prefix for autocomplete",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "api_key": []
          }
        ],
        "responses": {
          "200": {
            "description": "bla bla",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
    },
    "securitySchemes": {
      "api_key": {
        "type": "apiKey",
        "name": "x-api-key",
        "in": "header"
      }
    }
  }
}