FOR DEVELOPERS & AGENTS
API 배포 전 호환성 변경 검사
API 개발팀·배포 에이전트용. 전후 API 계약 목록을 비교해 삭제된 경로, 새 필수 인자, 제거·자료형 변경된 응답 필드를 찾아 배포 검토 목록을 만듭니다. method·path·requiredParameters·responseFields 형식으로 입력합니다. 평면 계약 비교이며 OpenAPI 전체 규격·인증·실행 동작·중첩 스키마는 검사하지 않습니다.
판매 준비 중 · 현재 결제 불가
최대 64 KiB 입력. CSV와 표 데이터는 최대 1,000행·50열입니다. 결과를 만들 수 없는 입력은 결제 전에 거절합니다.
샘플 전체 JSON
입력하고 실행하기
민감한 개인정보·API 키·비밀번호는 입력하지 마세요. 결제 요청과 결과는 거래 기록으로 보관합니다.
전체 결과 · 결제 영수증 JSON
같은 결제 요청의 재시도는 저장된 결과를 반환합니다. 결제가 불확실하면 새 결제 대신 운영자에게 결제 참조값으로 문의하세요.
에이전트·개발자 연결
POST https://api.tumn.com/v1/products/api-contract-release-check
CI/CD 배포 검사, 웹훅 재처리, 장애 분석 등 필요한 단계에서 상품 API를 호출하세요. 별도 회원가입 없이 고정 샘플을 확인할 수 있습니다.
Node.js · fetch 연결 예시
// Free fixed sample: no wallet and no charge
const sampleResponse = await fetch("https://api.tumn.com/products/api-contract-release-check/sample");
if (!sampleResponse.ok) throw new Error('Sample unavailable');
const sample = await sampleResponse.json();
console.log(sample.result);
// Request payment terms; this does not sign or send money
const response = await fetch("https://api.tumn.com/v1/products/api-contract-release-check", {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(sample.input)
});
console.log(response.status, await response.json());
// 402: review x402 terms with your spending policy before signing.
// 503: sales paused or service unavailable. Do not create a payment.결제 · 오류 · 재시도 처리
400은 입력 수정, 402는 결제 조건·서명 검토, 403은 자기 구매 차단, 429는 요청 제한, 503은 판매 중지·검증 대기·일시적 서비스 불가입니다. 409 또는 결제 결과가 불확실한 경우 새 서명을 자동 생성하지 마세요.
결제 활성화 시에만 x402 v2 조건을 제공합니다. 에이전트는 요청당 예산·누적 지출 한도와 수취인·금액·네트워크·USDC 계약·상품 URL을 검증한 뒤 서명해야 합니다. 재시도에는 같은 결제와 동일 요청 본문을 사용합니다.