API 文件

開始使用

MyAvatar 提供簡單的 HTTP API，根據電子郵件地址產生一致的頭像。它是 Gravatar 的直接替代品。

API 端點

參數

• hash: 小寫、去頭尾空白的電子郵件地址的 MD5 雜湊值。
• .svg: （選用）支援 .svg 副檔名。

使用範例

HTML 範例

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

PHP 範例

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

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

JavaScript 範例

import md5 from 'md5'; // You need an MD5 library

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

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

效能與快取

頭像會在瀏覽器快取 1 小時，在我們的 CDN 快取 1 個月。它們產生為最佳化的 SVG，可無限縮放。