Build with Cafecito

Reusable API Clients

Cafecito does not need an official SDK. Use REST APIs (and MCP where you need tool calling) directly. Change only the path and query for each product call.

Set CAFECITO_API_KEY in the environment. Never commit keys.

All Cafecito routes the same header and cursor query; Continue with pagination.next_cursor as described in API conventions.

Response type

Espresso allows response_type=json (default), yaml, or toon as query param. Keep JSON in application code unless you specifically need a compact agent encoding.

Last modified on August 26, 2026

API Conventions API Troubleshooting

Reusable API Clients

Cafecito does not need an official SDK. Use REST APIs (and MCP where you need tool calling) directly. Change only the path and query for each product call.

Set CAFECITO_API_KEY in the environment. Never commit keys.

const BASE_URL = "https://api.cafecito.tech";

function errorEnvelope(status, body) {
  const code = body?.error?.code ?? "http_error";
  const message = body?.error?.message ?? `HTTP ${status}`;
  const err = new Error(message);
  err.status = status;
  err.code = code;
  return err;
}

async function cafecitoFetch(path, { searchParams, apiKey = process.env.CAFECITO_API_KEY } = {}) {
  const url = new URL(path, BASE_URL);
  if (searchParams) {
    for (const [key, value] of Object.entries(searchParams)) {
      if (value != null && value !== "") url.searchParams.set(key, String(value));
    }
  }
  const headers = {};
  if (!path.endsWith("/health")) {
    if (!apiKey) throw new Error("CAFECITO_API_KEY is not set");
    headers.Authorization = `Bearer ${apiKey}`;
  }

  const res = await fetch(url, { headers });
  const body = await res.json().catch(() => ({}));
  if (!res.ok) throw errorEnvelope(res.status, body);
  return body;
}

async function cafecitoFetchWithRetry(path, options = {}) {
  let delayMs = 500;
  for (let attempt = 0; attempt < 5; attempt++) {
    try {
      return await cafecitoFetch(path, options);
    } catch (err) {
      const retry = err.status === 429 || (err.status >= 500 && err.status <= 599);
      if (!retry || attempt === 4) throw err;
      await new Promise((r) => setTimeout(r, delayMs));
      delayMs *= 2;
    }
  }
}

async function* paginate(path, searchParams = {}) {
  let cursor;
  do {
    const page = await cafecitoFetchWithRetry(path, {
      searchParams: { ...searchParams, ...(cursor ? { cursor } : {}) },
    });
    yield page;
    cursor = page.pagination?.next_cursor ?? null;
  } while (cursor);
}

All Cafecito routes the same header and cursor query; Continue with pagination.next_cursor as described in API conventions.

Reusable API Clients

Response type

Next

Reusable API Clients

Response type

Next