로스트아크 API 사용하기

몽자비루 ㅣ 2024. 6. 8. 21:32

  1. 로스트아크에서 제공하는 APi 전체 사용해보기
  2. 사전 준비
    1. https://developer-lostark.game.onstove.com/ 에서 API key 값 받기
    2. 로스트아크 API는 동일한 key값과 보안을 사용하고 있기 때문에,
      collection Authrization 설정 후, 하위 requests 의 Authorization 을 inherit auth from parent 으로 설정.

    3. Lostark_API > Environment variabe 세팅
    4. NEWS
      1. GET /news/notices : 공지사항 목록 반환.
      2. GET /news/events : 진행 중인 이벤트 목록 반환.
    5. CHARACTERS
      1. GET /characters/{characterName}/siblings : 계정의 모든 캐릭터 프로필 반환.
    6. ARMORIES
      1. GET /armories/characters/{characterName} : 프로필 정보 요약을 캐릭터 이름별로 반환.
      2. 아래 다른 API 는 위 ARMORIES 뒤에 /{{value}} 를 넣으면 실행가능.
    7.  AUCTIONS
      1. GET /auctions/options : 경매장에 대한 검색 옵션 반환.
      2. POST /auctions/items : 검색 옵션이 포함된 모든 활성 경매 반환.
        • 검색하고자 하는 옵션
        • Body ( 7-1 내용 참고하기)
          {
            "ItemLevelMin": 0,
            "ItemLevelMax": 1700,
            "ItemGradeQuality": null,
            "SkillOptions": [
              {
                "FirstOption": null,
                "SecondOption": null,
                "MinValue": null,
                "MaxValue": null
              }
            ],
            "EtcOptions": [
              {
                "FirstOption": 3,
                "SecondOption":255,
                "MinValue": null,
                "MaxValue": null
              },
              {
                "FirstOption": 3,
                "SecondOption": 240,
                "MinValue": null,
                "MaxValue": null
              }
            ],
            "Sort": "BIDSTART_PRICE",
            "CategoryCode": 30000,
            "CharacterClass": "바드",
            "ItemTier": null,
            "ItemGrade": "유물",
            "ItemName": null,
            "PageNo": 0,
            "SortCondition": "ASC"
          }


        • 검색 결과 확인


    8. GUILDS
      1. GET /guilds/rankings : 서버별 길드 순위 목록을 반환.
        • parameter : serverName: 니나브
    9. MARKETS
      1. GET /markets/options : 시장에 대한 검색 옵션을 반환.
      2. POST /markets/items : 검색 옵션이 포함된 모든 활성 시장 항목을 반환.
        • Body ( 9-1 내용 참고하기)
          {
            "Sort": "GRADE",
            "CategoryCode": 20000,
            "CharacterClass": "바드",
            "ItemTier": null,
            "ItemGrade": null,
            "ItemName": "피로연",
            "PageNo": 2,
            "SortCondition": "ASC"
          }
        • 검색 결과 확인 : 응답값 중 Id 값 아래에 복사.
      3. GET /markets/items/{itemId} : 마켓아이템을 ID별로 반환.
    10. GAMECONTENTS
      1. GET /gamecontents/challenge-abyss-dungeons : 이번주 챌린지 어비스 던전 목록을 반환.
      2. GET /gamecontents/challenge-guardian-raids : 이번 주 챌린지 가디언 레이드 목록을 반환.
      3. GET /gamecontents/calendar : 이번 주 달력 목록을 반환.