Dokumentacija

Ovo je product-facing reference za public API. Isti identity, tenant, style version, avatar family, style options, size i WebP output namijenjeni su stabilnosti unutar major release.

Core Endpoints

GET /v1/avatar: returns an avatar asset directly
GET /v1/avatar/link: stores the generated avatar in configured object storage and returns signed-link metadata
GET /avatar/<kind>/<identity>/webp: path-style public avatar URL
GET /docs/openapi.json: machine-readable API description

Operativni Endpointi

GET /healthz je public za load balancers i uptime checks. GET /metrics je loopback-only i vraća 404 za non-local peers.

Namespace Podrška

Koristite tenant i style_version za odvajanje visual identity spaces između proizvoda ili rollout faza.

GET https://hashavatar.app/v1/[email protected]&tenant=acme&style_version=v2&algorithm=sha512&kind=wizard&background=white&accessory=hat&color=deep-sea-blue&expression=cool&shape=squircle&format=webp&size=256

Anonimni ID-jevi

Pošaljite internal stable id ili one-way application hash umjesto raw personal data.

printf '%s' '[email protected]' | sha256sum | cut -d' ' -f1

Rate Limits

Public service primjenjuje origin-side rate limits, sa strožim limitima za /v1/avatar/link, direct avatar requests s persist=true i /og.png jer su object storage writes i Open Graph image rendering skuplji od direct rendering.

Timeouts

Avatar generation i storage operations ograničeni su server-side timeouts kako skupi zahtjevi ne bi mogli neograničeno monopolizirati origin.

Greške

400: nevažeći kind, unsupported algorithm ili format, size ili missing identity
408: generation ili storage timeout
429: rate limit exceeded
500: rendering ili storage failure

OpenAPI

Za generated clients ili tooling koristite /docs/openapi.json.