개발자
DXRating API 및 에이전트 리소스
DXRating이 공개한 API와 기계 판독형 탐색 리소스로 연동 기능, 도구와 에이전트 워크플로를 만들 수 있습니다.
시작하기
OpenAPI 스키마는 사용 가능한 작업, 입력과 출력에 대한 공식 명세입니다.
- API 기본 URL
- https://miruku.dxrating.net/api/v1
- OpenAPI 스키마
- https://miruku.dxrating.net/spec.json
- 대화형 API 문서
- https://miruku.dxrating.net/docs
- RFC 9727 API 카탈로그
- https://dxrating.net/.well-known/api-catalog
- 에이전트 가이드
- https://dxrating.net/llms.txt
접근 권한 및 안정성
공개 카탈로그
공개 카탈로그 엔드포인트와 API 문서는 DXRating 계정 없이 사용할 수 있습니다.
인증이 필요한 작업
일부 커뮤니티 및 계정 작업에는 DXRating 세션이 필요합니다. 각 작업의 요구 사항은 OpenAPI 스키마에서 확인하세요.
공개 베타
API는 계속 변경될 수 있습니다. 최신 스키마를 기준으로 연동을 검증하고 호환 가능한 추가 사항을 처리하세요.
에이전트 탐색
에이전트는 API 카탈로그와 llms.txt에서 동일한 API를 찾을 수 있습니다. DXRating 연동이 설치된 환경에서는 엔드포인트를 추측하지 말고 공개된 도구 스키마를 사용하세요.
연동 가이드
- 카탈로그 데이터를 내려받을 때 ETag와 조건부 요청을 사용하세요.
- 채보별 결과를 보여 줄 때는 DXRating의 정식 채보 URL을 반환하거나 인용하세요.
- 조건부 요청이나 목적에 맞는 엔드포인트로 충분하다면 전체 카탈로그를 반복해서 내려받지 마세요.