← Утилиты для разработчиков

Генерация аватара

GET /avatars/generate

Генерация уникальных URL изображений аватаров из начальной строки (например, имени пользователя или email). Возвращает URL из трёх различных сервисов: DiceBear (17 художественных стилей, SVG/PNG), UI Avatars (на основе инициалов) и RoboHash (роботы/монстры). Одна и та же начальная строка всегда создаёт один и тот же аватар, что делает его идеальным для дефолтных аватаров профилей.

Посмотрите визуализацию

Параметры

seed обязательный

Seed string (username, email, any text)

style необязательный по умолчанию: avataaars

DiceBear style name

size необязательный по умолчанию: 200

Image size in pixels

Примеры запросов

Базовое использование
curl "https://nordapi.ee/api/v1/avatars/generate?seed=john_doe"
Avatar for a username
curl "https://nordapi.ee/api/v1/avatars/generate?seed=john_doe"
Pixel art style, large
curl "https://nordapi.ee/api/v1/avatars/generate?seed=jane&style=pixel-art&size=400"
Robot avatar from email
curl "https://nordapi.ee/api/v1/avatars/generate?seed=user@example.com&style=bottts"

Ответ в реальном времени

HTTP 500: "# UndefinedFunctionError at GET /api/v1/avatars/generate\n\nException:\n\n    ** (UndefinedFunctionError) function App.Avatars.styles/0 is undefined (module App.Avatars is not available)\n        (app 0.1.0) App.Avatars.styles()\n        (app 0.1.0) lib/app_web/controllers/api/v1/avatars_controller.ex:6: AppWeb.API.V1.AvatarsController.generate/2\n        (app 0.1.0) lib/app_web/controllers/api/v1/avatars_controller.ex:1: AppWeb.API.V1.AvatarsController.action/2\n        (app 0.1.0) lib/app_web/controllers/api/v1/avatars_controller.ex:1: AppWeb.API.V1.AvatarsController.phoenix_controller_pipeline/2\n        (phoenix 1.8.5) lib/phoenix/router.ex:416: Phoenix.Router.__call__/5\n        (app 0.1.0) lib/app_web/endpoint.ex:1: AppWeb.Endpoint.plug_builder_call/2\n        (app 0.1.0) deps/plug/lib/plug/debugger.ex:155: AppWeb.Endpoint.\"call (overridable 3)\"/2\n        (app 0.1.0) lib/app_web/endpoint.ex:1: AppWeb.Endpoint.call/2\n        (phoenix 1.8.5) lib/phoenix/endpoint/sync_code_reload_plug.ex:22: Phoenix.Endpoint.SyncCodeReloadPlug.do_call/4\n        (bandit 1.10.4) lib/bandit/pipeline.ex:131: Bandit.Pipeline.call_plug!/2\n        (bandit 1.10.4) lib/bandit/pipeline.ex:42: Bandit.Pipeline.run/5\n        (bandit 1.10.4) lib/bandit/http1/handler.ex:13: Bandit.HTTP1.Handler.handle_data/3\n        (bandit 1.10.4) lib/bandit/delegating_handler.ex:18: Bandit.DelegatingHandler.handle_data/3\n        (bandit 1.10.4) lib/bandit/delegating_handler.ex:8: Bandit.DelegatingHandler.handle_continue/2\n        (stdlib 7.3) gen_server.erl:2424: :gen_server.try_handle_continue/3\n        (stdlib 7.3) gen_server.erl:2291: :gen_server.loop/4\n        (stdlib 7.3) proc_lib.erl:333: :proc_lib.init_p_do_apply/3\n    \n\n## Connection details\n\n### Params\n\n    %{\"seed\" => \"john_doe\"}\n\n### Request info\n\n  * URI: http://localhost:4000/api/v1/avatars/generate\n  * Query string: seed=john_doe\n\n### Headers\n  \n  * accept-encoding: gzip\n  * host: localhost:4000\n  * user-agent: req/0.5.17\n\n### Session\n\n    %{}\n"