Documentació de l'API

Començant

MyAvatar proporciona una API HTTP senzilla per generar avatars consistents basats en adreces de correu electrònic. És un substitut directe per a Gravatar.

Punt final de l'API

GET https://myavatar.onlc.eu/avatar/{hash}

Paràmetres

hash: El hash MD5 de l'adreça de correu electrònic en minúscules i sense espais.
.svg: (Opcional) L'extensió .svg és compatible.
d o default: (Opcional) Imatge per defecte quan cap avatar ha estat guardat. Establir a "mp" o "mystery" per mostrar una silueta buida.

Imatges per defecte

Quan un usuari no ha definit explícitament un avatar per a la seva adreça de correu electrònic, podeu especificar una imatge per defecte a mostrar. Utilitzeu d=mp per mostrar una silueta mystery person.

d=mp o d=mystery: Mostra una silueta grisa (persona misteriosa) en lloc de generar un avatar aleatori.
Omet el paràmetre d: Mostra l'avatar determinista generat automàticament (comportament per defecte).

Exemple:

<!-- Mostra una persona misteriosa si no existeix cap avatar -->
<img src="https://myavatar.onlc.eu/avatar/205e460b479e2e5b48aec07710c08d50?d=mp" alt="User Avatar" />

<!-- Mostra l'avatar determinista (per defecte) -->
<img src="https://myavatar.onlc.eu/avatar/205e460b479e2e5b48aec07710c08d50" alt="User Avatar" />

Exemples d'Ús

Exemple HTML

<img src="https://myavatar.onlc.eu/avatar/205e460b479e2e5b48aec07710c08d50" alt="MyAvatar" />

Exemple PHP

$email = "[email protected]";
$hash = md5(strtolower(trim($email)));
$avatarUrl = "https://myavatar.onlc.eu/avatar/" . $hash;

// Opcional: afegeix default=mp per mostrar una persona misteriosa quan no hi ha cap avatar desat
// $avatarUrl .= "?d=mp";

echo '<img src="' . $avatarUrl . '" />';

Exemple JavaScript

import md5 from 'md5'; // Necessites una biblioteca MD5

const email = "[email protected]";
const hash = md5(email.trim().toLowerCase());
const avatarUrl = `https://myavatar.onlc.eu/avatar/${hash}`;

// Opcional: afegeix ?d=mp per usar la persona misteriosa per defecte
// const avatarUrl = ... + "?d=mp";

const img = document.createElement('img');
img.src = avatarUrl;
document.body.appendChild(img);

Rendiment i Memòria Cau

Els avatars es guarden a la memòria cau del navegador durant 1 hora i al nostre CDN durant 1 mes. Es generen com a SVGs optimitzats per a una escalabilitat infinita.