Introducción

Cómo llamar a cualquier API del gateway: una clave, un header, una base URL.

En una llamada

Todas las APIs viven bajo https://api.tomasbarak.com/{api}/v1 y se autentican con el mismo header. No hay SDK obligatorio, no hay handshake y no hay token que expire.

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

Lo que hay que saber antes de integrar

La clave va siempre en el header. En la query string el gateway la rechaza con 401. Ver Autenticación.
Los límites corren por suscripción y por API, no por clave. Cinco claves no te dan cinco rate limits. Ver Límites y cuotas.
Toda respuesta —incluidas las de error— trae X-Request-Id. Es el identificador con el que se reclama un crédito de SLA. Ver SLA.
Las claves tb_test_ sirven los examples del contrato, no tocan el upstream y no consumen cuota. Ver Sandbox.

Entornos

Prefijo	Qué hace	¿Consume cuota?
`tb_live_`	Llama al upstream real y factura.	Sí
`tb_test_`	Devuelve los `examples` del OpenAPI. Honra `Prefer: code=` y `Prefer: example=`.	No
`tb_play_`	Interna del playground: la acuña el servidor, vive 15 minutos y nunca llega al browser.	No