권한
Updated:
x402 API에는 계정, 비밀번호 또는 API 키가 없습니다. 대신 결제 서명, 주문의 액세스 토큰, 지갑 서명이라는 세 가지 종류의 인증 수단이 사용됩니다.
접근 토큰을 제3자에게 제공하지 마시고, 당사를 포함하여 누구에게도 지갑의 개인 키를 절대 전송하지 마십시오.
주요 기능
결제 서명
결제를 승인하는 지갑이 구매자입니다. 첫 결제가 성공적으로 완료되면 지갑 계정이 자동으로 생성되므로 별도로 등록할 필요가 없습니다. 주문의 갱신 및 거주지 트래픽 요금은 해당 주문을 결제했던 지갑에서만 지불할 수 있습니다.
액세스 토큰
유료 주문 건마다 access_token 한 번은, 202 답변. 다음 주소로 보내주세요. Authorization 이 주문과 관련된 모든 요청에 대한 헤더: 상태 및 인증 정보, 갱신, 트래픽, 설정, IP 교체 및 이벤트.
지갑 서명
주문에 사용할 새로운 토큰을 받거나 잔액을 인출하려면, 동일한 지갑으로 일회용 문자 메시지(EIP-4361)에 서명하십시오. 서명만으로는 자금이 이동하지 않습니다.
액세스 토큰
Authorization: Bearer x402_q8Zt3Lw0mN6pR2vY9cK4hJ7sD1fG5bX8aE3uW0iO2nT속성 | 가치 |
|---|---|
서식 |
|
어디서 | 다음의 경우에만 |
범위 | 주문 내용: |
발행됨 | 각 작업마다 한 번씩, |
수명 | 주문 만료일로부터 90일까지이며, 갱신 시 기간이 연장됩니다. 만료일이 없는 작업의 경우, 최종 상태가 확정된 날로부터 90일 후까지입니다. |
취소 | 지갑 차단, |
새로운 토큰이 기존 토큰을 무효화하지 않습니다: 해당 주문의 모든 유효한 토큰은 계속 작동합니다.
오류
답변 | ~할 때 |
|---|---|
| 이 |
| 기타 문제: 주문이 존재하지 않음, 토큰이 다른 주문에 속함, 토큰이 취소되었거나 만료됨. API는 이러한 경우들을 구분하지 않습니다. |
예시
401: 접근 권한 없음
{
"error": "unauthorized",
"message": "Authorization is required",
"retryable": false,
"retry_action": "abandon",
"detail": "Authorization: Bearer <access_token> from the order response is required"
}잃어버린 토큰
토큰을 분실한 경우, 지갑을 통해 접근 권한을 복구하십시오: 접근 권한 복구. 응답에는 새로운 토큰이 포함된 지갑의 모든 주문 내역이 나열됩니다.