Dux integrationis

Auxilium

Utere hashavatar.app directe ex navigatro, frontend, aut backend tuo. Omne URL avataris determinatum est, ergo eadem identitas et optiones semper eundem exitum dant.

URL fundamentale

Utere endpoint query cum simplicem URL imaginis publicae vis.

https://hashavatar.app/v1/[email protected]&algorithm=sha512&kind=robot&background=white&accessory=glasses&color=gold&expression=happy&shape=circle&format=webp&size=256

URL formae viae

Utere forma viae si URLs ad includendum mundiores mavis.

https://hashavatar.app/avatar/fox/[email protected]/webp

Exemplum HTML

<img
  src="https://hashavatar.app/v1/[email protected]&algorithm=sha512&kind=monster&background=themed&accessory=horns&color=crimson&expression=grumpy&shape=hexagon&format=webp&size=256"
  alt="Generated monster avatar"
/>

Exemplum JavaScript

const avatarUrl = new URL("https://hashavatar.app/v1/avatar");
avatarUrl.search = new URLSearchParams({
  id: user.email,
  algorithm: "sha512",
  kind: "robot",
  background: "white",
  accessory: "glasses",
  color: "gold",
  expression: "happy",
  shape: "circle",
  format: "webp",
  size: "256",
}).toString();

Parametri sustentati

  • id: any stable identifier such as an email, username, internal user id, or one-way hash
  • tenant: optional namespace partition for multi-tenant apps
  • style_version: optional style namespace such as v2
  • algorithm: identity hash mode; only sha512 is supported
  • kind: any public hashavatar family, including cat, dog, robot, planet, rocket, frog, panda, cupcake, pizza, octopus, knight, bear, penguin, dragon, ninja, astronaut, diamond, coffee-cup, and shield
  • background: themed, white, black, dark, light, transparent, polka-dot, striped, checkerboard, grid, sunrise, ocean, or starry
  • accessory: none, glasses, hat, headphones, crown, bowtie, eyepatch, scarf, halo, or horns
  • color: default, neon-mint, pastel-pink, crimson, gold, or deep-sea-blue
  • expression: default, happy, grumpy, surprised, sleepy, winking, cool, or crying
  • shape: square, circle, squircle, hexagon, or octagon
  • format: output format; only webp is supported
  • size: from 64 up to 1024

Strata accessorii et expressionis familiis personarum applicantur. Familiae objectorum sicut planet, rocket, paws, mushroom, cactus, cupcake, pizza, icecream, diamond, coffee-cup et shield ad accessory=none et expression=default normalizantur.

Nexus repositorii subscripti

Si hoc deployment repositorium objectorum configuratum habet, nexum repositorii praescriptum a /v1/avatar/link pete. Hic endpoint objectum generatum servat et JSON cum URL subscripto, clave objecti, et clave cache hashata reddit. Responsa avatarum ordinaria metadata nexuum subscriptorum in response headers non exponunt.

GET https://hashavatar.app/v1/avatar/[email protected]&algorithm=sha512&kind=robot&background=white&accessory=glasses&color=gold&expression=happy&shape=circle&format=webp&size=256

Fons apertus

Fons situs publici in repositorio API habitat et renderer avatarum reutilis in crates.io publicatur. Repositorium · crates.io