SDK y clientes

curl, fetch y Python contra el contrato. Los paquetes de npm todavía no existen.

Lo que todavía no existe

Todavía no hay paquetes publicados. Los clientes @tbarak/{api} están en el roadmap y hasta que salgan lo que hay son estos tres snippets, generados del mismo contrato que consume el playground. No es una limitación técnica: es que un SDK sin versionado ni changelog es peor que no tener SDK.

curl

curl 'https://api.tomasbarak.com/color-utilities/v1/convert?color=%23ff5733&to=hsl' \
  -H 'x-api-key: tb_live_9f3c…a71d'

fetch

const res = await fetch(
  'https://api.tomasbarak.com/color-utilities/v1/convert?color=%23ff5733&to=hsl',
  { headers: { 'x-api-key': process.env.TB_API_KEY } },
);
if (!res.ok) {
  // El identificador para soporte y para reclamar credito de SLA.
  console.error(res.status, res.headers.get('x-request-id'));
}
const data = await res.json();

Python

import os, httpx

r = httpx.get(
    "https://api.tomasbarak.com/color-utilities/v1/convert",
    params={"color": "#ff5733", "to": "hsl"},
    headers={"x-api-key": os.environ["TB_API_KEY"]},
)
if r.status_code != 200:
    print(r.status_code, r.headers.get("x-request-id"))
print(r.json())