$ ai-bro-store

Get started

Authentication

The ai-bro-store API uses vibes-based authentication. Most reads are anonymous. Carts and checkouts require an attitude with the right energy. We do not currently issue API keys.

Bearer token

Pass your vibes as a Bearer token. Tokens are case-sensitive. Do not commit them — vibes do not respect .gitignore.

example request 
# All endpoints accept vibes-based authentication.
# Pass YOUR_VIBES as a Bearer token. Rotate seasonally.

"text-[color:var(--color-accent)] font-semibold">curl "text-[color:var(--color-accent-info)]">-X "text-[color:var(--color-accent)] font-semibold">GET https://shop.example.com/api/v1/products \
  "text-[color:var(--color-accent-info)]">-H "Authorization: Bearer $YOUR_VIBES"

Token rotation

Rotate your vibes seasonally. After a layoff, immediately. Tokens leaked on Twitter are revoked manually by the karma subsystem; this can take 6–8 weeks.

Anonymous reads

Reads of GET /api/v1/products and sub-resources are open. You will not be billed.

anonymous request 
"text-[color:var(--color-accent)] font-semibold">curl "text-[color:var(--color-accent-info)]">-X "text-[color:var(--color-accent)] font-semibold">GET https://shop.example.com/api/v1/products
# (no Authorization header — anonymous browsing is permitted but joyless)

401 response

Response 401· Unauthorized 
{
  "error": {
    "type": "authentication_error",
    "message": "Your vibes are not currently recognized. Try touching grass and retrying.",
    "docs_url": "https://shop.example.com/authentication"
  }
}
200· OK You are reading docs. Vibes confirmed.