TechDNA API 시작하기
공통 안내API를 호출하기 전에 필요한 인증 방식, 테스트 방법과 공통 응답 규칙을 안내합니다.
인증과 API 키
모든 외부 API 요청에는 발급받은 키를 X-TD-API-KEY 헤더로 전달합니다. API 키는 호출 주체와 허용된 기능을 식별하며 요청 본문에 포함하지 않습니다.
X-TD-API-KEY: YOUR_API_KEY기본 요청 주소
운영 환경에서 안내받은 API 호스트 뒤에 각 엔드포인트 경로를 연결합니다.
https://td-api-service.techdna.kr/api/...API 테스트
왼쪽의 API 엔드포인트를 선택하면 오른쪽 테스트 콘솔이 해당 요청 항목으로 바뀝니다. API 키와 필요한 값만 입력한 뒤 요청을 보내면 실제 응답과 처리 시간을 확인할 수 있습니다. 일반 API는 키별 분당 10회, 유사특허 분석은 분당 3회까지 테스트할 수 있습니다.
1엔드포인트 선택
2API 키 입력
3요청값 확인
4응답 확인
공통 응답과 HTTP 코드
정상 처리의 비즈니스 코드는 0이며, 실제 결과는 data에 반환됩니다.
{ "code": 0, "data": {} }200요청 처리
400검증 오류
401키 누락·오류
403scope 부족
503인증·서버 장애