# 개발자가 회사 로고 API를 고를 때 진짜 봐야 하는 것

> 대부분의 로고 API는 가져오는 것만 해결한다. 더 어려운 문제는 표현이다. 대시보드, CRM, 계정 목록이 시각적으로 일관되려면 모든 로고가 배경 인식, 자동 크롭, 비율 맞춤된 상태로 들어와야 한다.

## 실제로 중요한 네 가지

- **배경 처리** — 브랜드 배경이 있는 경우 이를 존중할 수 있어야 한다.
- **여백과 크롭** — 로고가 공간을 낭비하거나 중심이 어긋나 보이면 안 된다.
- **비율 일관성** — 같은 UI 슬롯 안에서 브랜드마다 시각적 무게가 제각각이면 안 된다.
- **통합 경로** — 브라우저 앱에서 서버를 강제하지 않는 사용 흐름이 필요하다.

## ClearLogo가 명확하게 집중하는 지점

ClearLogo는 raw retrieval보다 usable output에 맞춰 설계됐다. 배경 인식, 자동 크롭, 비율 맞춤 결과와 브라우저 친화 public-key 흐름에 집중하기 때문에 대시보드, CRM, 엔리치먼트 툴, 내부 제품 화면에 잘 맞는다.

### 요청 예시

```
GET https://api.clearlogo.dev/logo/example.com?size=128&content=80
```

```html
<img
  src="https://api.clearlogo.dev/logo/example.com?token=YOUR_BROWSER_KEY"
  alt="Example company logo"
/>
```

## 잘 맞는 사용 사례

- 회사 테이블과 디렉터리
- CRM과 세일즈 툴
- 대시보드 안의 계정 목록
- 별도 서명 서비스 없이 로고 URL이 필요한 브라우저 앱

## 자주 묻는 질문

### "배경 인식(background-aware)" 이란 무엇인가요?

ClearLogo는 브랜드 로고가 컬러 배경 또는 다크 배경을 전제로 만들어졌는지 판단해 응답에 그 배경을 보존한다. 무조건 투명 PNG를 반환해서 라이트 배경 위에서 깨져 보이게 하지 않는다는 뜻이다.

### 백엔드 없이도 사용할 수 있나요?

네. 브라우저 키는 `Origin`/`Referer` 매칭으로 요청을 인가하므로, 프론트엔드 코드의 `<img>` 태그에 URL을 바로 넣을 수 있다. Bearer 토큰 인증이 필요할 때만 서버 키를 사용하면 된다.

### 어떤 로고 포맷을 반환하나요?

기본은 PNG, `format` 파라미터로 `webp` 또는 `jpeg`를 선택할 수 있고 `Accept` 헤더로 자동 협상된다. 현대 브라우저는 자동으로 WebP를 받는다.

### 어떤 경우에 ClearLogo를 골라야 하나요?

로고가 UI 슬롯에 나란히 놓이는 화면 — 대시보드, CRM, 계정 목록, 엔리치먼트 화면 — 에서 비율 맞춤과 배경 처리가 차이를 만든다.