API 키

온라인에서 아이콘을 검색하려면 macosicons.com의 API 키가 필요합니다. API 키가 없어도 로컬 이미지 파일을 사용할 수 있습니다.

API 키 발급

1. macosicons.com을 방문하여 계정을 만듭니다.
2. 계정 설정에서 API 키를 요청합니다.
3. 키를 복사합니다.

키 입력

1. IconChanger를 엽니다.
2. 설정 > 고급으로 이동합니다.
3. API Key 필드에 API 키를 붙여넣습니다.
4. 연결 테스트를 클릭하여 정상적으로 작동하는지 확인합니다.

API 키 없이 사용

API 키 없이도 다음과 같은 방법으로 앱 아이콘을 변경할 수 있습니다:

• 로컬 이미지 파일 사용 (로컬에서 선택 클릭 또는 이미지 드래그 앤 드롭)
• 앱에 내장된 아이콘 사용 ("로컬" 섹션에 표시됨)

고급 API 설정

설정 > 고급 > API 설정에서 API 동작을 세밀하게 조정할 수 있습니다:

설정	기본값	설명
재시도 횟수	0 (재시도 없음)	실패한 요청을 재시도하는 횟수 (0–3)
타임아웃	15초	각 요청의 타임아웃 시간
월간 제한	50	월별 최대 API 쿼리 수

월간 사용량 카운터에 현재 사용량이 표시됩니다. 매월 1일에 자동으로 초기화되며, 수동으로 초기화할 수도 있습니다.

아이콘 검색 캐시

Cache API Results를 활성화하면 검색 결과가 디스크에 저장됩니다. 캐시된 결과는 앱 재시작 후에도 유지되어 API 사용량을 줄여줍니다. 아이콘을 탐색할 때 새로고침 버튼을 사용하면 최신 결과를 가져올 수 있습니다.

문제 해결

API 테스트에 실패하는 경우:

• 키가 올바른지 확인합니다 (공백이 포함되지 않았는지 확인)
• 인터넷 연결을 확인합니다
• macosicons.com API가 일시적으로 사용 불가능할 수 있습니다