Taarifa Ya Faragha

Faragha

Service hii imeundwa kwa makusudi kuwa rahisi, lakini public avatar API bado hupokea baadhi ya request data ili kufanya kazi. Ukurasa huu unaeleza practical baseline hiyo.

Service Inapokea Nini

  • opaque identifier unayoweka kwenye request, kama internal id, username, au one-way hash
  • request parameters kama avatar type, style options, size, format, na background
  • standard HTTP metadata inayoshughulikiwa na server, reverse proxy, na CDN, kama IP address, user agent, referrer, na request timing

App Huhifadhi Nini

Application haihitaji user accounts na haiweki application cookies kwa default. Katika basic request flow, app hutengeneza avatar on demand na kuirudisha moja kwa moja.

Ikiwa object storage support imewashwa na signed-link au persistence route inatumika, generated avatar file na object key zinaweza kuhifadhiwa kwenye configured S3-compatible bucket.

Telemetry Inayolinda Faragha

Ikiwa operator anawasha telemetry, app hutuma aggregate OpenTelemetry metrics kwa page views, visible page time, repository na crate clicks, demo actions, na avatar generation counts zilizopangwa kwa bounded style choices kama kind, background, accessory, color, expression, shape, na size bucket.

Telemetry haina raw identifiers, tenant au style namespace values, IP addresses, user agents, referrers, full URLs, cookies, au free-form text. Telemetry endpoints hupokea tu allow-listed aggregate labels.

Logs Na Infrastructure

Kulingana na deployment, infrastructure components kama nginx, Caddy, Cloudflare, hosting providers, au S3-compatible storage zinaweza kuhifadhi access logs na operational metadata. Logs hizi ni sehemu ya kuendesha public service na zinaweza kuwa na requested identifier ikiwa inaonekana kwenye URL.

Nini Ni Bora Kutopeleka

Email-shaped identifiers zinakubaliwa kwa compatibility, lakini URLs zinaweza kuonekana kwenye infrastructure logs. Tuma stable internal id au one-way application hash ikiwa unataka kuepuka personal data kwenye request URL.

Repository Na Crate

Unaweza kukagua implementation kwenye public API repository na reusable avatar renderer kwenye Rust crate. Repository · Rust Crate

Maelezo ya tafsiri

Tafsiri za tovuti zimesaidiwa na AI na zimefanywa kwa juhudi bora. Ukiona maneno yanayopaswa kuboreshwa, michango kwenye GitHub inakaribishwa. Boresha tafsiri