Method: projects.locations.endpoints.submitOperationalTransaction

운영 트랜잭션을 네트워크에 제출합니다. 이 메서드는 트랜잭션이 네트워크의 대부분의 유효성 검사기에 복제된 후에만 반환되거나 트랜잭션이 실패한 경우에만 반환됩니다.

HTTP 요청


POST https://universalledger.googleapis.com/v1/{endpoint=projects/*/locations/*/endpoints/*}:submitOperationalTransaction

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
endpoint

string

필수 항목입니다. 요청을 처리할 엔드포인트입니다. 형식: projects/{project}/locations/{location}/endpoints/{endpoint} 위치는 리전입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "serializedSignedOperationalTransaction": string
}
필드
serializedSignedOperationalTransaction

string (bytes format)

필수 항목입니다. 원장에 제출할 protobuf 직렬화된 SignedTransaction입니다. 동봉된 클라이언트 거래는 운영 거래여야 하며 발신자는 플랫폼 운영자여야 합니다. 직렬화된 형식을 사용하면 모든 유효성 검사기가 직렬화된 바이트의 SHA-256 다이제스트와 동일한 트랜잭션 ID를 계산합니다.

base64 인코딩 문자열입니다.

응답 본문

endpoints.submitOperationalTransaction의 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현
{
  "transactionDigestHex": string
}
필드
transactionDigestHex

string

제출된 운영 거래를 고유하게 나타내는 식별자입니다. serializedSignedOperationalTransaction의 SHA-256 다이제스트의 16진수 표현입니다. 이 거래 ID는 클라이언트가 해싱 로직을 직접 구현하지 않고도 거래를 추적할 수 있도록 제공됩니다. 식별자는 후속 API 호출에서 직접 사용할 수 있습니다(예: 거래 상태를 쿼리하는 경우).

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참고하세요.