API Reference

createWebhook

post
https://web3.luniverse.io/v1///webhooks

Webhook을 생성하기 위한 API입니다. 구독하고자 하는 이벤트 타입과 조건, 구독을 받을 Webhook URL을 등록할 수 있습니다.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
❗️

Listener Endpoint(Webhook URL)는 모든 POST 요청에 대해 200 OK로 응답해야 합니다.

Listener Endpoint는 개발자의 선호에 따라 다양한 방식으로 구현 또는 제공될 수 있습니다. 유일한 제약사항은, 모든 Listener Endpoint는 유입되는 POST 요청에 대해 항상 Http Status Code 200 OK로 응답해야 한다는 것입니다. 200 OK 이외의 다른 응답 코드가 반환되는 경우, 루니버스 서버는 이를 비정상적인 Endpoint로 판단하여 요청을 반복적으로 재시도하거나 Webhook 목록에서 예고 없이 제거할 수 있습니다.

Path Params
string
required
Defaults to ethereum

조회 대상 Chain 프로토콜을 지정하기 위한 파라미터입니다.
지원되는 프로토콜에 대한 정보는 Supported Chains페이지를 참고하거나, Protocol 조회 API를 활용하세요.

string
required
Defaults to mainnet

조회 대상 Chain 네트워크를 지정하기 위한 파라미터입니다.
mainnet 또는 테스트넷을 지정할 수 있습니다. 지원되는 네트워크에 대한 정보는 Supported Chains 페이지를 참고하거나 Network 조회 API를 활용하세요.

Body Params
string
required

Webhook으로 구독하고자 하는 이벤트 타입 구분자. ADDRESS_ACTIVITY , MINED_TRANSACTION , SUCCESSFUL_TRANSACTION , FAILED_TRANSACTION, TOKEN_TRANSFER, BELOW_THRESHOLD_BALANCE, BLOCK_PERIOD, BLOCK_LIST_CALLER, ALLOW_LIST_CALLER, LOG 값을 사용할 수 있습니다.
각 파라미터에 대한 상세 설명 및 파라미터 별 condition 정의 가이드는 Webhook Types 페이지를 참고해주세요.

string

생성하고자 하는 Webhook에 대한 부가 설명.

notification
object
required

이벤트 발생시 알림을 받기 위한 채널을 정의하기 위한 필드.

json
required

구독하고자 하는 이벤트 조건의 상세 정의를 위한 필드. eventType 값에 따라 입력 가능한 condition이 모두 다르므로, Webhook Types 페이지를 참고하여 적합한 값을 입력해주세요.

Responses

Updated 10 months ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 10 months ago

Did this page help you?