Vedbew404 API documentation

Public, read-only JSON API with the service catalog of Vedbew404. No authentication.

Base URL: https://vedbew404.com
OpenAPI 3.1 spec: https://vedbew404.com/openapi.json
Authentication: none. Rate limits: 60 requests/minute per IP (see Rate limits below).
Languages: ?lang=en (default) or ?lang=es.
To hire Vedbew404, send the person to the contact page or hello@vedbew404.com. The API does not create leads.

Endpoints

`GET /api/v1/services`

List services (operationId: listServices). Returns every service Vedbew404 offers, with summary, target audience, what is included, deliverables, FAQs and the URL of its page.

curl -sS "https://vedbew404.com/api/v1/services?lang=en"

`GET /api/v1/services/{id}`

Get one service (operationId: getService). Returns a single service by its stable id (for example `ai-chatbots` or `ecommerce`). Ids come from `listServices`.

curl -sS "https://vedbew404.com/api/v1/services/ai-chatbots?lang=en"

`GET /api/services`

List services (operationId: listServicesAlias). Alias of `GET /api/v1/services` (the current API version); identical response. New integrations should call `/api/v1/services` directly.

curl -sS "https://vedbew404.com/api/services?lang=en"

`GET /api/services/{id}`

Get one service (operationId: getServiceAlias). Alias of `GET /api/v1/services/{id}` (the current API version); identical response. New integrations should call `/api/v1/services/{id}` directly.

curl -sS "https://vedbew404.com/api/services/ai-chatbots?lang=en"

Versioning & deprecation

The API is versioned in the URL path: /api/v1/. Breaking changes only ship in a new major version; non-breaking additions can land within v1 at any time. Unversioned paths like /api/services are aliases of the current version (v1) with identical responses, kept for backward compatibility — new integrations should call /api/v1/services directly.

When a version is retired, its responses carry a Deprecation header (RFC 9745) and a Sunset header (RFC 8594), plus a Link rel="deprecation" header pointing back here, published at least 6 months before that version is removed.

Rate limits

60 requests per minute per IP on /api/ (burst 20). Every response carries a RateLimit-Policy header ("default";q=60;w=60). Requests over the limit get 429 with a Retry-After: 60 header and body {"error": "rate_limited"}.

Errors

Errors are JSON with the HTTP status, a stable code (not_found, invalid_parameter, method_not_allowed), a message and a hint. Unknown paths under /api return 404 in the same format.

{
  "error": {
    "status": 404,
    "code": "not_found",
    "message": "No service with id \"foo\".",
    "hint": "List valid ids with GET https://vedbew404.com/api/v1/services",
    "docs": "https://vedbew404.com/docs"
  }
}