Divvun API

Documentation for the Divvun API endpoints

Introduction

Welcome to the Divvun API documentation. This API provides endpoints for interacting with the Divvun service.

Base URL

All API endpoints are relative to the base URL:

https://api-giellalt.uit.no

Endpoints

Health Check

GET /health application/json

Check the health status of the API.

Response 
{
    "status": "ok"
}

Grammar Check

POST /grammar/:tag application/json

Check grammar for text. Available languages:

  • fo - føroyskt
  • ga - Gaeilge
  • kl - kalaallisut
  • nb - norsk bokmål
  • se - davvisámegiella
  • sma - Åarjelsaemien gïele
  • smj - julevsámegiella
  • smn - anarâškielâ
  • sms - nuõrttsääʹmǩiõll
Request application/json 
{
    "text": "sami"
}
Response application/json 
{
  "text": "sami",
  "errs": [
    {
      "error_text": "sami",
      "start_index": 0,
      "end_index": 4,
      "error_code": "typo",
      "description": "Ii leat sátnelisttus",
      "suggestions": [
        "sámi"
      ],
      "title": "Čállinmeattáhus"
    }
  ]
}

Spell Check

POST /speller/:tag application/json

Check spelling for text. Available languages:

  • se - davvisámegiella
  • sma - Åarjelsaemien gïele
  • smj - julevsámegiella
  • smn - anarâškielâ
  • sms - nuõrttsääʹmǩiõll
Request application/json 
{
    "text": "sami"
}
Response application/json 
{
  "text": "sami",
  "results": [
    {
      "word": "sami",
      "is_correct": false,
      "suggestions": [
        {
          "value": "sámi",
          "weight": 14.529631
        },
        {
          "value": "sama",
          "weight": 40.2973
        },
        {
          "value": "sáme",
          "weight": 45.896103
        },
        {
          "value": "sabmi",
          "weight": 50.2973
        },
        {
          "value": "samai",
          "weight": 50.2973
        },
        {
          "value": "sapmi",
          "weight": 50.2973
        },
        {
          "value": "satmi",
          "weight": 50.2973
        },
        {
          "value": "samo",
          "weight": 55.2973
        },
        {
          "value": "samu",
          "weight": 55.2973
        },
        {
          "value": "somá",
          "weight": 56.623154
        }
      ]
    }
  ]
}

Text-to-Speech

POST /tts/:tag/:voice audio/wav

Convert text to speech. Available languages and voices:

Request application/json 
{
    "text": "Sample text to convert to speech"
}
Response audio/wav

WAV audio file containing the synthesized speech.