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