Docs인증 (Auth)
인증 (Authentication)
모든 FindIP API 요청은 Authorization 헤더를 통한 Bearer 토큰 인증이 필요합니다.
API 키 형식
API 키는 psk_live_xxxxxxxxxxxxxxxx 형식을 따릅니다. 대시보드에서 키를 생성하고 관리할 수 있습니다.
주의
API 키를 안전하게 보관하세요. 클라이언트 사이드 코드, 공개 저장소(Public Repository), 또는 브라우저 요청에 노출되지 않도록 하세요. 서버 환경 변수나 서버 사이드 프록시를 사용해야 합니다.
인증된 요청 보내기
API 키를 Authorization 헤더에 Bearer 접두사와 함께 포함하세요.
cURL
curl -X POST https://api.findip.ai/search \
-H "Authorization: Bearer psk_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{"query": "semiconductor etching process", "top_k": 5}'Python
import requests
response = requests.post(
"https://api.findip.ai/search",
headers={
"Authorization": "Bearer psk_live_your_api_key",
"Content-Type": "application/json",
},
json={
"query": "semiconductor etching process",
"top_k": 5,
},
)
data = response.json()JavaScript (Node.js)
const response = await fetch("https://api.findip.ai/search", {
method: "POST",
headers: {
"Authorization": "Bearer psk_live_your_api_key",
"Content-Type": "application/json",
},
body: JSON.stringify({
query: "semiconductor etching process",
top_k: 5,
}),
});
const data = await response.json();요청 한도 (Rate Limiting)
검색 호출은 구독 플랜의 월 한도에서 차감됩니다. 상세조회·도면·번호조회는 카운팅하지 않습니다. 한도를 초과하면 API는 429 Too Many Requests 오류를 반환합니다. 모든 호출에 분당 60회 rate limit이 별도로 적용됩니다.
| 플랜 | 월 검색 한도 |
|---|---|
| 무료 (Free) | 월 30회 |
| 베이직 (Basic) | 월 300회 |
| 프로 (Pro) | 월 1,000회 |
| 엔터프라이즈 | 별도 협의 |
키 관리
대시보드에서 API 키를 쉽게 관리할 수 있습니다.
- 다양한 환경(개발, 프로덕션)에 맞춰 여러 개의 키 생성
- 유출된 키를 즉시 폐기(Revoke)
- 키 별 사용량 및 요청 로그 모니터링