Skip to content
Aura Live Documentation

List languages

GET
/languages/

Ce point d’accès, publiquement accessible, retourne une liste de toutes les langues prises en charge par le système.

Il est possible de filtrer les résultats en utilisant des paramètres dans l’URL pour affiner la recherche.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
name
string

Filtre les langues pour trouver une correspondance exacte avec le nom complet (ex: “English”).

iso_639_1
string

Filtre les langues pour trouver une correspondance exacte avec le code ISO (ex: “en”).

skip
integer

The number of items to skip from the beginning of the result set. This is used for pagination, often referred to as the ‘offset’.

limit
integer

The maximum number of items to return in the response. This is used to control the page size.

Example
100

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful response (inferred from assertions)

object
data
required
Array<object>
object
id
required

The unique numeric identifier for the language. This is the internal primary key.

integer
Example
10
iso_639_1
required

The standard two-letter ISO 639-1 code for the language. This is the primary field you should use when specifying a language for a new transcription session.

string
Example
en
name
required

The full, human-readable name of the language in English.

string
Example
English
active
required

Indicates whether the language is currently available for transcription. An inactive language (false) cannot be selected when creating a new live session.

boolean
Example
true
pagination
required
object
total_items
required

The total number of items available in the entire dataset that match the query, across all pages.

integer
total_pages
required

The total number of pages calculated from total_items and per_page. A client can use this to build page navigation UI.

integer
current_page
required

The page number for the current set of items being returned. This is typically controlled by skip and limit or page and size query parameters.

integer
per_page
required

The maximum number of items configured to be returned on a single page. This is typically controlled by a limit query parameter.

integer
Example
{
  "data": [
    {
      "iso_639_1": "en",
      "name": "English",
      "id": 1,
      "active": true
    },
    {
      "iso_639_1": "fr",
      "name": "French",
      "id": 2,
      "active": true
    },
    {
      "iso_639_1": "de",
      "name": "German",
      "id": 3,
      "active": true
    },
    {
      "iso_639_1": "es",
      "name": "Spanish",
      "id": 4,
      "active": true
    }
  ],
  "pagination": {
    "total_items": 4,
    "total_pages": 1,
    "current_page": 1,
    "per_page": 100
  }
}