{"id":21652134,"url":"https://github.com/andcool-systems/eldraxis","last_synced_at":"2025-03-20T04:07:41.020Z","repository":{"id":229847031,"uuid":"776119798","full_name":"Andcool-Systems/Eldraxis","owner":"Andcool-Systems","description":"Eldraxis skin API","archived":false,"fork":false,"pushed_at":"2025-01-05T10:16:54.000Z","size":37,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-25T05:43:53.214Z","etag":null,"topics":["api","minecraft","prisma","python3","skin"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Andcool-Systems.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-03-22T18:09:50.000Z","updated_at":"2025-01-05T10:16:56.000Z","dependencies_parsed_at":"2024-03-26T15:51:57.506Z","dependency_job_id":"51ddc610-e43c-4020-b298-b868fff2b122","html_url":"https://github.com/Andcool-Systems/Eldraxis","commit_stats":null,"previous_names":["andcool-systems/minecraft-skin-api","andcool-systems/eldraxis"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Andcool-Systems%2FEldraxis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Andcool-Systems%2FEldraxis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Andcool-Systems%2FEldraxis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Andcool-Systems%2FEldraxis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Andcool-Systems","download_url":"https://codeload.github.com/Andcool-Systems/Eldraxis/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244547604,"owners_count":20470103,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","minecraft","prisma","python3","skin"],"created_at":"2024-11-25T07:51:20.737Z","updated_at":"2025-03-20T04:07:41.002Z","avatar_url":"https://github.com/Andcool-Systems.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Eldraxis project\n[![Made for pepeland](https://andcool.ru/static/badges/made-for-ppl.svg)](https://pepeland.net)  \nThis API acts as an intermediary between the client and the official Mojang skins server. For greater convenience, the API caches incoming requests for 3 hours. Unlike the official Mojang skins server, this API requires only one request to obtain a skin image by nickname.    \n\nThe rate limit for all endpoints is 100 requests per minute.\n\n## Usage\n### `GET /profile/{nickname/uuid}`  \nGet account info by nickname/UUID.  \n\nHere's an example response:  \n```json\n{\n  \"status\": \"success\",\n  \"message\": \"\",\n  \"timestamp\": 1716588437430,\n  \"uuid\": \"1420c63cb1114453993fb3479ba1d4c6\",\n  \"uuid_dashed\": \"1420c63c-b111-4453-993f-b3479ba1d4c6\",\n  \"nickname\": \"AndcoolSystems\",\n  \"textures\": {\n    \"SKIN\": {\n      \"mojang\": \"http://textures.minecraft.net/texture/9c52c2cf06d363321a0ec5530960755c3dea860b3e67e5c9ca9eb33a136e46e0\",\n      \"eldraxis\": \"https://eldraxis.andcool.ru/skin/1420c63cb1114453993fb3479ba1d4c6\"\n    },\n    \"CAPE\": {\n      \"mojang\": \"http://textures.minecraft.net/texture/afd553b39358a24edfe3b8a9a939fa5fa4faa4d9a9c3d6af8eafb377fa05c2bb\",\n      \"eldraxis\": \"https://eldraxis.andcool.ru/cape/1420c63cb1114453993fb3479ba1d4c6\"\n    }\n  },\n  \"eldraxis_cache\": {\n    \"available_in_search\": true,\n    \"last_cached\": 1716586283000\n  }\n}\n```\n\n\n\n### `GET /skin/{nickname}?cape=\u003cbool\u003e`  \nRetrieve a skin by nickname.\n\u003e ### Query parameter `cape` determines the format of the returned skin.\n\u003e The default value of the parameter is `false`. With this value, the response `Content-Type` header will be `image/png`. In this case, the endpoint will return only the skin as an image.  \n\u003e If the parameter `cape` is set to `true`, the endpoint will have a `text/json` `Content-Type` header, and the response will contain images of the skin and cape in `base64` format.\n```json\n{\n  \"status\": \"success\",\n  \"data\": {\n    \"skin\": \"\u003cbase64 encoded skin\u003e\",\n    \"cape\": \"\u003cbase64 encoded cape\u003e\"\n  }\n}\n```\n\u003e [!NOTE]\n\u003e If your account does not have a cape, the `cape` field in the server response will be an empty string.\n\n\n## Get 2D head by nickname\n### `GET /head/{nickname}`  \nReturns image of minecraft skin head by nickname.  \n`Content-Type: image/png`  \n\u003e [!NOTE]\n\u003e The request is subject to caching\n\n\n## Get 3D head by nickname\n### `GET /head3d/{nickname}?v=-25\u0026h=45`  \nReturns image of 3D render of minecraft skin head by nickname.  \n`Content-Type: image/png`  \n\u003e The parameters `v` and `h` are responsible for the vertical and horizontal rotation of the render, respectively. The standard values are shown in the sample query (-25, 45).  \n\n\u003e [!NOTE]\n\u003e The request is subject to caching\n\n## Get cape by nickname\n### `GET /cape/{nickname}`  \nReturns image of minecraft account cape by nickname.  \n`Content-Type: image/png`  \n\u003e [!NOTE]\n\u003e The request is subject to caching\n\n## Search by nickname\n### `GET /search/{nickname-fragment}?take=\u003ctake\u003e\u0026page=\u003cpage\u003e`  \nThis endpoint will return all cached entries whose nickname contains the given fragment.\n\n\u003e The `take` parameter specifies the maximum number of nicknames returned in the search (default is 20).  \n\u003e The `page` parameter determines which page will be sent when requesting nicknames. Calculated by the formula `skip = take * page`.\n\nIf no nicknames containing the given fragment are found, the HTTP status code will be `204`.\n\n#### Example Response\n```json\n{\n  \"status\": \"success\",\n  \"requestedFragment\": \"AndcoolSystems\",\n  \"data\": [\n    {\n      \"name\": \"AndcoolSystems\",\n      \"head\": \"\u003cbase64 encoded skin head\u003e\"\n    }\n  ],\n  \"total_count\": 1,\n  \"next_page\": 1\n}\n```\n\u003eThe `total_count` field contains the total number of records found, regardless of the `take` and `page` parameters.  \n\u003eThe `next_page` field contains the number of the next page.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandcool-systems%2Feldraxis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandcool-systems%2Feldraxis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandcool-systems%2Feldraxis/lists"}