인증
API로 보내는 모든 요청에는 API 키가 포함됩니다. 요청은 브라우저 세션과 연결되지 않습니다.
API 키 만들기
계정의 API 키에서 최대 5개까지 만들 수 있습니다. 로그인한 상태라면 언제든지 그 페이지에서 API 키를 복사할 수 있습니다. 당사는 키를 암호화해 보관하며 고객님에게만 보여 드립니다. 비밀번호처럼 비밀로 유지하고, 노출되었을 수 있다면 폐기한 뒤 새 키를 만드세요.
API 키 보내기
Authorization 헤더에 Bearer와 그 뒤에 키를 붙여 보내세요. X-API-Key도 사용할 수 있습니다.
curl "https://api.talismanleads.io/v1/account" \
-H "Authorization: Bearer tl_live_your_key_here"API 키로 할 수 있는 일
새 API 키로는 모든 작업을 할 수 있습니다. 잔액, 체커, 주문과 그 결과를 볼 수 있고, 목록을 저장하거나 잔액을 사용하는 POST /uploads, POST /estimates, POST /orders도 사용할 수 있습니다. 2026년 11월 8일 이전에 만든 키는 읽기 전용일 수 있습니다. 이 경우 모든 것을 볼 수는 있지만, 이 세 가지 호출은 missing_scope로 거부됩니다.
만료와 IP 주소
새 API 키는 만료되지 않으며 어느 주소에서나 작동합니다. 2026년 11월 8일 이전에 만든 키에는 만료일이 있을 수 있으며, 만료 후에는 expired_key로 거부됩니다. 또는 서버의 IP 주소로 제한되어 있어 다른 곳에서 온 요청이 ip_not_allowed로 거부될 수 있습니다. 둘 중 하나를 바꾸려면 새 키를 만들고 이전 키를 폐기하세요.
API 키 안전하게 보관
- API 키를 비밀번호처럼 다루세요. 키를 가진 사람은 누구나 잔액을 사용할 수 있습니다.
- 서버에서만 사용하세요. API는 웹페이지에서의 호출을 허용하지 않습니다.
- 코드와 버전 관리에 넣지 마세요.
- API 키가 노출되었을 수 있다면 계정에서 즉시 폐기하세요. 바로 작동을 멈춥니다. 이미 접수된 주문은 계속 실행됩니다.
- API로만 보내세요. 업로드 및 다운로드 링크에는 자체 권한이 있으므로 이 링크로 API 키를 보내지 마세요.
API 키가 거부되는 경우
잘못되었거나, 폐기되었거나, 만료된 API 키는 401을 응답합니다. 차단된 API 키나 계정은 403을 응답합니다. 오류를 참고하세요.