eatch.dev/eiv2: 개인 로고 API (v2)

원하는 색 조합과 설정을 URL로 전송하면 그 색과 설정이 적용된 제 로고를 응답으로 받을 수 있습니다. <img>나 파비콘 등 이미지 링크가 필요한 곳에 넣어서 사용할 수 있습니다.

구 API는 /ei에서 확인할 수 있으며, 당분간은 계속 운영할 예정입니다.

이 문서 페이지를 제외한 모든 응답은 90일 동안 캐시되도록 설정되어 있습니다.

정적 파일

/eiv2/favicon.ico와 /eiv2/apple-touch-icon.png는 파비콘용으로 따로 준비한 정적 파일이며, 흰색 원형 배경과 검은색 주 색상(= /eiv2/c/0_0_f)으로 고정되어 있습니다.

아래의 동적 엔드포인트를 파비콘으로 사용하는 것은 권장하지 않지만, 굳이 사용한다면 원형 배경을 사용하는 것이 미관상 좋습니다.

/eiv2/favicon.ico

/eiv2/apple-touch-icon.png

0자리, 1자리, 2자리, 3자리, 6자리의 16진수로 색상을 지정할 수 있습니다. 자릿수에 따라 다음과 같은 의미를 가집니다.

여러 색상 코드를 입력할 때는 밑줄(_)로 구분합니다. 레거시 API에서 사용하던 대시(-)는 더 이상 사용할 수 없습니다.

기본적인 로고를 생성합니다. 매개변수 :palette에는 2~3개의 색상 코드를 입력합니다.

첫 번째 색이 주 색상(좌하단 잎의 색), 두 번째 색이 보조 색상(우하단 줄기의 색), 세 번째 색이 배경색입니다. 세 번째 색이 없을 경우 투명 배경이 됩니다. 좌상단과 우상단 잎의 색은 직접 설정할 수 없으며, 주 색상과 보조 색상을 혼합한 색으로 결정됩니다.

주 색상과 보조 색상이 일치할 경우 단색 로고가 생성됩니다. 단색 로고는 가독성을 위해 일부 획에 테두리가 추가되어 있습니다. 레거시 API에서 사용하던 플래그 s는 더 이상 사용할 수 없습니다.

플래그가 설정된 로고를 생성합니다. 각 플래그는 알파벳 한 글자이며, 순서는 상관 없고 중복도 허용하지만 대소문자는 구분합니다. 중복 없이 입력할 것을 강력히 권장합니다.

플래그가 없는 경우(/eiv2//:palette)는 지원하지 않으며, /eiv2/:palette 엔드포인트를 사용해야 합니다.

현재 지원하는 플래그의 목록은 다음과 같습니다.

a: 애니메이션. 로고에 애니메이션이 적용됩니다. 테두리 역시 지원합니다.
- SVG 애니메이션은 최초 로딩될 때 한 번만 재생되므로 다시 확인하려면 강제 새로고침을 하거나 캐시 무효화 기법을 사용해야 합니다. 내려받은 SVG 코드를 HTML에 직접 복사하는 것을 권장합니다.
c: 원형 배경. 불투명 배경이 사각형 대신 원형이 됩니다. 배경이 없을 경우 무시합니다.
o: 테두리. 단색 로고가 아닐 경우에도 강제로 테두리를 추가합니다.
O: 테두리 제거. 단색 로고일 경우에도 강제로 테두리를 제거합니다.