postman&API
로스트아크 API 사용하기
몽자비루
2024. 6. 8. 21:32
- 로스트아크에서 제공하는 APi 전체 사용해보기
- 사전 준비
- https://developer-lostark.game.onstove.com/ 에서 API key 값 받기
- 로스트아크 API는 동일한 key값과 보안을 사용하고 있기 때문에,
collection Authrization 설정 후, 하위 requests 의 Authorization 을 inherit auth from parent 으로 설정. - Lostark_API > Environment variabe 세팅
- lostark_tokent : 2-1에서 받은 인증키
- lostark_url : https://developer-lostark.game.onstove.com
- characterName : 임의의 캐릭터 이름
- NEWS
- GET /news/notices : 공지사항 목록 반환.
- GET /news/events : 진행 중인 이벤트 목록 반환.
- GET /news/notices : 공지사항 목록 반환.
- CHARACTERS
- GET /characters/{characterName}/siblings : 계정의 모든 캐릭터 프로필 반환.
- GET /characters/{characterName}/siblings : 계정의 모든 캐릭터 프로필 반환.
- ARMORIES
- GET /armories/characters/{characterName} : 프로필 정보 요약을 캐릭터 이름별로 반환.
- 아래 다른 API 는 위 ARMORIES 뒤에 /{{value}} 를 넣으면 실행가능.
- GET /armories/characters/{characterName} : 프로필 정보 요약을 캐릭터 이름별로 반환.
- AUCTIONS
- GET /auctions/options : 경매장에 대한 검색 옵션 반환.
- 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" }
- 검색 결과 확인
- 검색하고자 하는 옵션
- GET /auctions/options : 경매장에 대한 검색 옵션 반환.
- GUILDS
- GET /guilds/rankings : 서버별 길드 순위 목록을 반환.
- parameter : serverName: 니나브
- parameter : serverName: 니나브
- GET /guilds/rankings : 서버별 길드 순위 목록을 반환.
- MARKETS
- GET /markets/options : 시장에 대한 검색 옵션을 반환.
- POST /markets/items : 검색 옵션이 포함된 모든 활성 시장 항목을 반환.
- Body ( 9-1 내용 참고하기)
{ "Sort": "GRADE", "CategoryCode": 20000, "CharacterClass": "바드", "ItemTier": null, "ItemGrade": null, "ItemName": "피로연", "PageNo": 2, "SortCondition": "ASC" }
- 검색 결과 확인 : 응답값 중 Id 값 아래에 복사.
- Body ( 9-1 내용 참고하기)
- GET /markets/items/{itemId} : 마켓아이템을 ID별로 반환.
- GET /markets/options : 시장에 대한 검색 옵션을 반환.
- GAMECONTENTS
- GET /gamecontents/challenge-abyss-dungeons : 이번주 챌린지 어비스 던전 목록을 반환.
- GET /gamecontents/challenge-guardian-raids : 이번 주 챌린지 가디언 레이드 목록을 반환.
- GET /gamecontents/calendar : 이번 주 달력 목록을 반환.
- GET /gamecontents/challenge-abyss-dungeons : 이번주 챌린지 어비스 던전 목록을 반환.