연동하기
API
제품·백엔드에서 REST로 유미의 검증된 매장 데이터를 바로 불러와. 키 발급 → 헤더에 키 → 첫 호출이면 끝이야.
API 키는 대시보드에서 발급해. 키 원문은 만들 때 딱 한 번만 보이니까, 안전한 곳에 보관해둬.
API 키 받기 →- 01
키 발급
대시보드에서 API 키를 만들어. 평문 키는 발급 시 딱 한 번만 보여.
- 02
헤더에 키 넣기
모든 요청에 Authorization: Bearer <KEY> 한 줄만 넣으면 돼. (URL의 ?api_key=는 로그에 남기 쉬워 비추천·폐기 예정)
- 03
첫 호출
/api/v1/places로 한번 검색해봐. 호출할 때마다 토큰이 정확히 빠지고, 한도를 넘으면 429를 돌려줘.
example
curl -H "Authorization: Bearer YOUR_KEY" \ "https://api.heyyumi.ai/api/v1/places?keyword=burger&min_confidence=0.7"
호출하면 얼마나 써?
받고 싶은 필드를 고른 만큼만 토큰이 빠져. 기본(core)은 가벼워서 적게 들고, 연락처·평점·상세처럼 풍부한 필드를 일부러 요청할 때만 조금 더 들어. 고른 필드에 따라 비용이 정해지니까 예측 가능하고. Open Season 동안 개인 사용은 무료라, 하루 70 토큰까지 써볼 수 있어. 상업적·대량 사용이나 더 큰 한도가 필요하면 문의해줘.
상업·대량 사용 문의 →