문서

유저 상점

유저 상점에 지금 무엇이 등록되어 있는지 조회합니다.

이 문서의 목차 (1)

유저 상점 조회#

GET /v1/shops/user/{uuid 또는 닉네임}

키 필요

유저 상점 조회는 아직 준비 중이에요. 지금은 이 엔드포인트를 부르면 항상 503 이 와요. 열리면 공지로 알려드릴게요.

curl -H "Authorization: Bearer ml_…" \
     https://api.mcmi.kr/v1/shops/user/rihacats

{
  "data": {
    "owner": { "uuid": "cfd95c20-…", "name": "rihacats" },
    "shops": [
      {
        "id": "shop_01",
        "name": "리하 상점",
        "listings": [
          {
            "id": "listing_01",
            "item": { "id": "mcmi:steel_ingot", "name": "강철 주괴", "amount": 1 },
            "price": { "currency": "gold", "amount": 120 },
            "stock": 64,
            "listedAt": 1789000000000
          }
        ]
      }
    ]
  },
  "meta": { "read_only": true }
}
중요

조회 전용입니다#

이 API로는 사거나 파실 수 없습니다. 등록 목록을 보여드리는 것이 전부입니다.
거래는 인게임에서만 이루어집니다. meta.read_only 가 항상 true 인 이유입니다.

시세 추적기나 "어디서 살 수 있는지" 검색기를 만드시는 데 쓰시면 좋습니다.

참고

가격은 골드와 루비만 표시됩니다.
다른 재화로 등록된 항목은 price 가 null 로 옵니다 — 물건은 있지만 가격을 알려드리지 않는 상태이니, 화면에 "가격 미표시"로 처리해 주세요.

경고

이 엔드포인트는 게임 서버 브릿지를 거칩니다.
준비되지 않은 동안에는 503 이 옵니다.

API 개요 · 문서 API

댓글

댓글은 마코노미 디스코드 서버 멤버만 쓸 수 있어요. 디스코드로 로그인