개발자
자체 서버에서 모든 체커 실행
TalismanLeads API는 웹사이트와 같은 일을 합니다. 목록을 보내고, 가격을 확인하고, 주문하고, 결과를 가져옵니다. 같은 잔액에서 같은 가격으로 결제합니다.
이용 방법
API 키 만들기
계정에서 API 키를 만드세요. 한 번만 표시되므로 안전한 곳에 보관하세요.
견적
목록을
POST /estimates로 보내 가격과 목록의 문제를 확인하세요. 요금은 청구되지 않습니다.주문하기
같은 목록을
Idempotency-Key와 함께POST /orders로 보내세요. 몇 번을 보내든 그 주문은 한 번만 청구됩니다.결과 가져오기
완료될 때까지
GET /orders/{id}를 확인한 다음GET /orders/{id}/results에서 파일을 받으세요.
빠른 시작
키를 자신의 API 키로 바꾸세요. 기본 주소는 https://api.talismanleads.io/v1이며, 요청과 응답은 JSON입니다.
1. 비용 확인
curl -X POST "https://api.talismanleads.io/v1/estimates" \
-H "Authorization: Bearer tl_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{"checker":"whatsapp_status_detection","entries":["+14155550142","+12125550187"]}'2. 주문하기
curl -X POST "https://api.talismanleads.io/v1/orders" \
-H "Authorization: Bearer tl_live_your_key_here" \
-H "Idempotency-Key: crm-export-2026-11-05" \
-H "Content-Type: application/json" \
-d '{"checker":"whatsapp_status_detection","entries":["+14155550142","+12125550187"]}'3. 상태 확인
curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f" \
-H "Authorization: Bearer tl_live_your_key_here"4. 결과 받기
curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f/results" \
-H "Authorization: Bearer tl_live_your_key_here"알아 두기
- 금액은 항상 미국 달러 문자열입니다(예:
"18.00"). - 모든 파일은 최소 2,000건으로 청구되며, API와 웹사이트 모두 같습니다.
- 100,000건 이하이면서 4 MB 이하인 목록은 요청에 넣을 수 있습니다. 더 큰 목록은 10,000,000건 또는 200 MB까지
POST /uploads를 통해 보냅니다. - 주문 상태는 30초 이상의 간격으로 확인하세요. 주문에 걸리는 시간은 크기와 체커에 따라 다릅니다.
POST /estimates와POST /orders의 응답을 최대 5분까지 기다리세요. 큰 목록은 읽는 데 시간이 걸립니다. 제한 시간을 더 짧게 두면 공연히 다시 보내게 됩니다.