크레딧 지갑

GET

/api/v1/billing/wallet

const url = 'https://dev.api.endueos.com/api/v1/billing/wallet';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://dev.api.endueos.com/api/v1/billing/wallet \
  --header 'Authorization: Bearer <token>'

내 계정의 지갑. 없으면 만들고 가입 크레딧을 지급한다 (원장 grant) — 계정당 한 번이다 (프로젝트마다 주지 않는다). ENDUE-1105: endue 크레딧 환경(source = endue)이면 가입 크레딧이 없고, endue 잔액과 맞춘 뒤 돌려준다 — endue 를 읽지 못하면 503 WALLET_UNAVAILABLE.

인증

응답

200

성공.

application/json

object

data

필수

계정당 하나 (프로젝트마다가 아니다). 크레딧이 endue OS 안의 유일한 화폐다. ENDUE-1105: source 가 endue 면 이 지갑은 endue 크레딧 잔액(endue AI 지갑, 1 크레딧 = US$1)의 거울이다 — balance = 마지막으로 받은 endue 잔액 + 아직 endue 로 보내지 않은 OS 사용. 충전은 endue 구매로 한다(/billing/purchase-options).

object

source

endue — endue 크레딧의 거울(ENDUE-1105). 없으면 OS 자체 지갑(옛 동작).

string

허용 값: endue

payer_user_id

Any of:

string
null

usr_{Keycloak sub} — ULID 가 아니다.

string

/^usr_.+$/

balance_decimal

string

available_credits

Any of:

string
null

string

unposted_estimated_credits

Any of:

string
null

string

reserved_credits

string

cost_status

string

balance

필수

잔액 (크레딧). 음수가 될 수 있다 — 그러면 비용을 만드는 동작이 402 INSUFFICIENT_CREDITS 로 막히고 running virtual Device 가 멈춘다.

number format: double

currency

필수

string

허용 값: credit

low_balance

필수

잔액이 100 크레딧 미만이다.

boolean

updated_at

필수

string format: date-time

meta

필수

object

request_id

필수

string

timestamp

필수

string format: date-time

duration

서버 처리 시간(ms).

integer format: int32

예시

{
  "data": {
    "source": "endue",
    "currency": "credit"
  }
}

401

인증이 없거나 무효다 — UNAUTHORIZED. 본문은 오류 봉투.

403

이 인증 수단으로는 못 하는 일이다 — FORBIDDEN (예: API 키로 클라우드 기기 만들기). 본문은 오류 봉투.

429

한도를 넘었다 — Retry-After 초 뒤에 다시. 본문은 오류 봉투.

500

서버 오류 — INTERNAL_ERROR. 본문은 오류 봉투.

503

의존 서비스에 닿지 못했다 — 잠시 뒤 다시. 본문은 오류 봉투.