glossaries

Listar glosarios

Un glosario por pareja de idiomas, ordenados alfabéticamente por pareja, con su recuento de términos y el límite del plan. Los términos se omiten por defecto y se devuelven solo al obtener un único glosario, o si pasas expand=terms aquí para obtener el contenido completo de una página de glosarios en una sola llamada. La paginación se basa en cursores: pasa el next_cursor de la respuesta anterior literalmente. El parámetro expand=terms limita el tamaño de la página a 10, ya que, de lo contrario, los términos de un glosario no tendrían límite de tamaño.

GET/v1/glossaries

Request

curl --request GET \
  --url 'https://api.ai-glot.com/v1/glossaries' \
  --header 'Authorization: <api-key>'

import json
import requests

url = "https://api.ai-glot.com/v1/glossaries"
headers = {
  "Authorization": "<api-key>"
}

response = requests.request("GET", url, headers=headers)
print(response.json())

<?php
$client = curl_init();

curl_setopt($client, CURLOPT_URL, "https://api.ai-glot.com/v1/glossaries");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
]);
curl_setopt($client, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($client);
curl_close($client);
echo $response;

package main

import (
  "fmt"
  "io"
  "net/http"
)

func main() {
  req, _ := http.NewRequest("GET", "https://api.ai-glot.com/v1/glossaries", nil)
  req.Header.Set("Authorization", "<api-key>")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  data, _ := io.ReadAll(res.Body)
  fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var request = HttpRequest.newBuilder(URI.create("https://api.ai-glot.com/v1/glossaries"))
    .header("Authorization", "<api-key>")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

var response = HttpClient.newHttpClient().send(
    request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

require 'net/http'
require 'json'

uri = URI("https://api.ai-glot.com/v1/glossaries")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "<api-key>"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end

puts response.body

application/json

{
  "data": [
    {
      "language_pair": "<string>",
      "source_language": "<string>",
      "target_language": "<string>",
      "term_count": 123,
      "max_terms": 123,
      "terms": {},
      "created_at": "<string>",
      "updated_at": "<string>"
    }
  ],
  "has_more": true,
  "next_cursor": null,
  "limit": 123,
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

Requiere glossaries:read. La lista contiene resúmenes de forma predeterminada: el par de idiomas de cada glosario, el número de términos y el límite del plan, sin incluir los términos en sí.

Pasa el parámetro expand=terms para obtener el mapa completo de términos de cada glosario de la página en una única llamada, en lugar de realizar una solicitud por glosario. Dado que los términos de un glosario no tienen un límite de tamaño predefinido, expand=terms fija el tamaño de la página en 10; continúa paginando con next_cursor de la forma habitual.

Contenido completo de términos para una página de glosariosGET /v1/glossaries?expand=terms&limit=10

Este endpoint no realiza ningún cambio ni consume créditos.

Respuesta

application/json

Listar glosarios

dataobject[]required

Show child attributes

language_pairstringrequired

source_languagestringrequired

target_languagestringrequired

term_countintegerrequired

max_termsinteger | nullrequired

termsRecord<string, string>

created_atstringrequired

updated_atstringrequired

has_morebooleanrequired

next_cursorstringnullrequired

limitintegerrequired

request_idstringrequired

{ "data": [ { "language_pair": "<string>", "source_language": "<string>", "target_language": "<string>", "term_count": 123, "max_terms": 123, "terms": {}, "created_at": "<string>", "updated_at": "<string>" } ], "has_more": true, "next_cursor": null, "limit": 123, "request_id": "<string>" }

Listar glosarios

Respuesta

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown