Ganadería JS Beefmasters — Developer Portal

Public API documentation for Ganadería JS Beefmasters. This is a small, read-only content API — no accounts, no transactional endpoints — documented in full below.

Authentication

None required. Every endpoint below is public and unauthenticated. There is no API key to request or manage — rate limiting (next section) is applied per client IP instead of per key.

Rate limits

GET /, /sitemap.xml, /llms.txt, and any 404 are limited to 120 requests per 60-second window per client IP. Every response on those paths carries:

Header names follow draft-ietf-httpapi-ratelimit-headers. Exceeding the limit returns 429 with a Retry-After header (seconds), content-negotiated the same as every other response on this site (JSON, Markdown, or HTML — see Quickstart).

Versioning & deprecation policy

GET /, /{unknownPath} 404s, /sitemap.xml, and /llms.txt all carry an API-Version header (currently 1). /developers (this page) and /openapi.json itself are meta-resources and aren't versioned — there's nothing on them for a consumer to pin against. There's no URL path versioning today because there's one resource family (content, not transactional data). If a breaking change ever ships, the version increments and, for at least 90 days beforehand, the outgoing version's responses add a RFC 8594 Sunset header naming the cutover date.

This policy is also machine-readable: see info.x-versioning-policy in /openapi.json.

Endpoints

Full schemas: /openapi.json (OpenAPI 3.1.0).

Quickstart

Fetch the homepage as Markdown instead of HTML:

curl -H "Accept: text/markdown" https://ganaderiajsbeefmasters.com/

Inspect the rate-limit headers on any covered path:

curl -sI https://ganaderiajsbeefmasters.com/ | grep -i ratelimit

A 404 on an unlisted path, as JSON (the default):

curl https://ganaderiajsbeefmasters.com/no-such-page

{
  "error": {
    "code": "not_found",
    "message": "No resource exists at /no-such-page.",
    "resolution": "See / for the homepage, /sitemap.xml for all indexed pages, or /llms.txt for a machine-readable index of this site's resources."
  }
}

Sandbox

There is no separate sandbox environment. Every endpoint above is read-only and safe to call directly against production, generously rate-limited — the quickstart commands above already are the sandbox.

CLI

ganaderiajs is the official command-line client for this API — a thin, zero-dependency wrapper around the endpoints above, useful for agents and scripts that would rather not hand-roll curl + header parsing.

npx ganaderiajs get / --format md
npx ganaderiajs status /
npx ganaderiajs sitemap --urls

Source, full command reference, and exit-code conventions: npmjs.com/package/ganaderiajs.

Machine-readable resources