Desarrolla

Empezar con el SDK

Clientes oficiales, sin dependencias. Una sola clave abre todas las APIs. Elige tu lenguaje y en dos líneas estás llamando.

Se generan solos desde el OpenAPI de la API, así que nunca se quedan atrás: cada ruta GET nueva aparece en el SDK. Python y JavaScript están publicados (versión 1.3.0 o posterior); R se instala desde su repositorio y Java va en código fuente. ¿Tu clave? En tu cuenta. ¿La referencia de la API? En Empezar.

🐍 Python

Sin dependencias (solo librería estándar).

Instalación

pip install "wordkers>=1.3.0"

Uso

from wordkers import Wordkers

wk = Wordkers("TU_CLAVE")          # tu API key

wk.silabear("murciélago")          # {'silabas': 'mur=cié=la=go', 'n_silabas': 4, 'silaba_tonica': 3}
wk.acentuar("cancion")             # sin tonica= no sabe dónde va la tilde: te lo dice en «nota»
wk.genero("masticable")            # {'genero': 'C', 'invariable': True}
wk.pluralizar("luz")               # {'plural': 'luces', ...}
wk.lematizar("casas")              # {'lemas': [{'lema': 'casa', ...}, ...]}

Configuración

wk = Wordkers("TU_CLAVE", base_url="https://api.wordkers.com", timeout=15)

Errores

from wordkers import WordkersError
try:
    wk.silabear("hola")
except WordkersError as e:
    print(e.status, e)   # 401 clave inválida · 429 rate-limit

🟨 JavaScript / TypeScript

Sin dependencias (usa fetch; Node 18+ o navegador). Incluye tipos.

Instalación

npm install wordkers@^1.3.0

Uso

import { Wordkers } from "wordkers";

const wk = new Wordkers("TU_CLAVE");     // tu API key

await wk.silabear("murciélago");         // { silabas: "mur=cié=la=go", n_silabas: 4, silaba_tonica: 3 }
await wk.acentuar("cancion");           // sin tonica no sabe dónde va la tilde: te lo dice en «nota»
await wk.genero("masticable");           // { genero: "C", invariable: true }
await wk.pluralizar("luz");              // { plural: "luces", ... }
await wk.lematizar("casas");

Configuración

const wk = new Wordkers("TU_CLAVE", { baseUrl: "https://api.wordkers.com", timeout: 15000 });

Errores

import { WordkersError } from "wordkers";
try { await wk.silabear("hola"); }
catch (e) { if (e instanceof WordkersError) console.log(e.status); }   // 401 · 429
En el navegador: no expongas una clave privada en un front público — usa una clave de demo con límite, o un proxy.

📊 R y ☕ Java

Salen del mismo generador y con los mismos nombres (wk$silabear("murciélago") en R, wk.silabear("murciélago") en Java). R se instala desde su repositorio público:

install.packages("remotes")
remotes::install_gitlab("wordkers-abierto/sdk-r")
library(wordkers)
wk <- wordkers("TU_CLAVE")
wk$silabear("murciélago")

Java está en código fuente en su repositorio (sin artefacto en Maven Central todavía): se compila con mvn package y se añade el .jar al proyecto. Si prefieres no compilar, desde Java se llama a la API con su cliente HTTP de siempre: un GET con la cabecera X-API-Key, como en la pestaña cURL de cada ficha del catálogo.

Los paquetes publicados: wordkers en PyPI y wordkers en npm (npm view wordkers). El código fuente de los cuatro, abierto: sdk-python, sdk-js, sdk-r y sdk-java. Se regeneran desde el OpenAPI de api.wordkers.com; cubren las rutas GET (las POST, como los lotes o /v1/texto/frases/fichero, se llaman con cURL o con fetch, como enseña cada ficha). Licencia CC BY 4.0 · Karb and Sil.

Wordkers · Catálogo · Empezar · Tu cuenta