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 
{
    "text": "sami"
}
Response 
{
  "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 
{
    "text": "sami"
}
Response 
{
  "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 
{
    "text": "Sample text to convert to speech"
}
Response

WAV audio file containing the synthesized speech.