존경하는 개발자 여러분, 환영합니다!

UJ EARTH는 개발자 분들이 이를 기반으로 한 여러 서비스를 제작하실 수 있도록 무료로 개발자용 API를 제공하고 있습니다! jinyoon.kr:6954/api 에서 API에 접근하실 수 있으며, 토큰 발급은 @Yeomoon 에게 문의해 발급받으실 수 있습니다 (디스코드 아이디 : republic_of_korea)

⚠️ 6974 포트가 아닌 6954 포트 입니다 꼭 기억해주세요!

토큰 인증

UJ EARTH는 Bearer 방식의 토큰 인증 방식을 사용하고 있습니다. 복잡할 거 같다고요? 전혀 아니에요! 아래 코드대로만 인증하면 바로 쓸 수 있을 정도로 간단하답니다 (아래 1234를 발급 받으신 토큰으로 바꿔주세요)

headers = {
    "Authorization": f"Bearer 1234"
}

response = requests.get("<http://jinyoon.kr:6954/api>", headers=headers)

송금 API

송금 API 입니다. 송금의 경우의는 돈을 보내는 쪽의 동의가 필요하기 때문에 세션으로 진행됩니다. 돈을 보내는 쪽이 동의를 할 경우 송금은 즉시 이루어 집니다. 주기적으로 세션 상태를 확인해주세요

http://jinyoon.kr:6954/api/send 를 호출해 API를 사용하실 수 있습니다!

세션 생성 [POST]

돈을 보내는 쪽과 받는 쪽, 그리고 송금 금액을 지정하여 세션을 만들 수 있습니다

세션을 생성하면 돈을 보내는 쪽에게 확인 메세지가 전송되며 이 확인 메세지는 최대 12시간동안 유효합니다

인자	타입	설명
sender	STR	돈을 보낼 플레이어의 UUID 또는 플레이어의 디스코드 ID
receiver	STR	돈을 받을 플레이어의 UUID 또는 플레이어의 디스코드 ID
coin	INT	송금할 금액

headers = {
    "Authorization": f"Bearer 1234",
    "Content-Type": "application/json"
}

data = {
    "sender": "724862211251765250",
    "receiver": "e5c5e0e8-b330-4b98-8452-6cceec82cd63",
    "coin": 1000
}

response = requests.post("<http://jinyoon.kr:6954/api/send>", headers=headers, json=data)

결과

성공 (200)

{
	"success": true, // BOOL
	"session": 123, // INT
	"sender": "713f22d4-225e-4d13-89a8-bc41718dd0e0", // STR (UUID)
	"receiver": "e5c5e0e8-b330-4b98-8452-6cceec82cd63", // STR (UUID)
	"coin": 1000 // INT
	"time": 1754362800 // INT (UNIX)
}

실패