현재 제공하고 있는 사이퍼즈 오픈 API 목록입니다.

• 01. 플레이어 검색 /cy/players  
  Request URL

  요청

  Response Preview

  Response Body

  요청변수|유형|설명|필수여부|기본값|최대값 -----|----|--------|:------------:|:---------:|:---------: nickname|String|닉네임 (URL 인코딩 필요)|Y|| wordType|String|검색타입<br>동일 단어(match), 전문 검색(full)<br>※ full의 경우 최소 2자에서 최대 8자까지 이용 가능||match| limit|Integer|반환 Row 수||10|200
• 02. 플레이어 `정보` 조회 /cy/players/:playerId  
  Request URL

  요청

  Response Preview

  Response Body

  요청변수|유형|설명|필수여부|기본값 ------------|:-----:|:-------:|:------------:|:---------: playerId|String|플레이어 고유 코드|Y|
• 03. 플레이어 `매칭 기록` 조회 /cy/players/:playerId/matches  
  Request URL

  요청

  Response Preview

  Response Body

  ## 참고 사항 >- startDate, endDate 요청 변수 사용 예시<br> &nbsp;&nbsp;ex) /matches?startDate=20180901T0000&endDate=20180930T2359<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; /matches?startDate=2018-09-01 00:00&endDate=2018-09-30 23:59<br> &nbsp;&nbsp;※ 기간 검색 요청 시 <font color="red">하나의 파라미터(startDate, endDate)라도 누락 될 경우 검색</font>이 불가능합니다.<br> &nbsp;&nbsp;※ 다양한 Date Type을 지원하지만, 상황에 따라 변경될 수 있으므로 예시 Date Type을 이용 부탁드립니다.<br> &nbsp;&nbsp;※ 초 단위 설정의 경우 startDate : 00초, endDate : 59초로 처리됩니다.<br> &nbsp;&nbsp;※ 기간 설정은 최대 <font color="red">90일</font>까지 가능합니다.<br><br> - next 요청변수 사용 예시<br> &nbsp;&nbsp;ex) /matches?next=&#60;next&#62;&apikey=&#60;apikey&#62;<br> &nbsp;&nbsp;※ next 사용 시 gameTypeId, limit, startDate, endDate등 요청변수는 최초 조회 기준으로 적용됩니다.<br><br> - 매칭 기록 갱신 주기<br> &nbsp;&nbsp;※ 공식 홈페이지 전적 검색과 동일하게 1시간마다 갱신됩니다.<br> 요청변수|유형|설명|필수여부|기본값|최대값 ------------|:----:|:--------:|:------------:|:---------: playerId|String|플레이어 고유 코드|Y|| gameTypeId|String|게임 타입<br>rating : 공식전<br>normal : 일반전||rating| startDate|Date|검색 시작일||현재 시간 기준 30일 전| endDate|Date|검색 종료일||현재 시간| limit|Integer|반환 Row 수|10|100| next|String|다음 데이터 조회|||
• 04. 매칭 상세 정보 조회 /cy/matches/:matchId  
  Request URL

  요청

  Response Preview

  Response Body

  ## 참고 사항 > 아이템 이미지 URL : https://img-api.neople.co.kr/cy/items/&#60;itemId><br> > 캐릭터 이미지 URL : https://img-api.neople.co.kr/cy/characters/&#60;characterId><br> 요청변수|유형|설명|필수여부|기본값 ------------|:----:|:--------:|:------------: matchId|String|매칭 고유 코드|Y|
• 05. 통합 랭킹 조회 /cy/ranking/ratingpoint  
  Request URL

  요청

  Response Preview

  Response Body

  요청변수|유형|설명|필수여부|기본값|최대값 ------------|:----:|:--------:|:------------:|:---------: playerId|String|플레이어 고유 코드||| offset|Integer|시작 지점||0| limit|Integer|반환 Row 수||10|1000
• 06. 캐릭터 랭킹 조회 /cy/ranking/characters/:characterId/:rankingType  
  Request URL

  요청

  Response Preview

  Response Body

  요청변수|유형|설명|필수여부|기본값|최대값 -----|----|--------|:------------:|:---------:|:---------: characterId|String|캐릭터 고유 코드|Y|| rankingType|String|랭킹 타입<br>(승리수: winCount, 승률: winRate, 킬: killCount, 도움: assistCount, 경험치:exp)|Y|| playerId|String|플레이어 고유 코드||| offset|Integer|시작 지점||0| limit|Integer|반환 Row 수||10|1000
• 07. 투신전 랭킹 조회 /cy/ranking/tsj/:tsjType  
  Request URL

  요청

  Response Preview

  Response Body

  요청변수|유형|설명|필수여부|기본값|최대값 -----|----|--------|:------------:|:---------:|:---------: tsjType|String|투신전 타입<br>(격: melee, 파: ranged)|Y|| playerId|String|플레이어 고유 코드||| offset|Integer|시작 지점||0| limit|Integer|반환 Row 수||10|1000
• 08. 아이템 검색 /cy/battleitems  
  Request URL

  요청

  Response Preview

  Response Body

  ## 참고 사항 > 아이템 이미지 URL : https://img-api.neople.co.kr/cy/items/&#60;itemId><br> 요청변수|하위변수|유형|설명|필수여부|기본값|최대값 -----|----|--------|------------|---------|--------- limit||Integer|반환 Row 수||10|100 itemName||String|아이템 명칭, URL 인코딩 하여 사용한다|Y|| wordType||String|검색타입<br>동일 단어(match), 앞 단어 검색(front), 전문 검색(full)<br>※ full의 경우 최소 2자에서 최대 12자까지 이용 가능||match| q=|||||| |characterId|String|캐릭터 고유 코드||| |slotCode|String|[장착 부위](/contents/guide/pages/all#사퍼-아이템-장착부위)||| |rarityCode|String|[아이템 레어리티](/contents/guide/pages/all#사퍼-아이템-레어리티)||| |seasonCode|String|[시즌](/contents/guide/pages/all#사퍼-아이템-시즌)|||
• 09. 아이템 상세 정보 조회 /cy/battleitems/:itemId  
  Request URL

  요청

  Response Preview

  Response Body

  ## 참고 사항 > 아이템 이미지 URL : https://img-api.neople.co.kr/cy/items/&#60;itemId><br> 요청변수|하위변수|유형|설명|필수여부|기본값|최대값 -----|----|--------|------------|---------|--------- itemId||String|아이템 고유 코드|||
• 10. 다중 아이템 상세 정보 조회 /cy/multi/battleitems  
  Request URL

  요청

  Response Preview

  Response Body

  ## 참고 사항 > 아이템 최대 30개 조회 가능합니다.<br> > 중복된 아이템 ID 요청 시 중복된 항목은 제거 됩니다.<br> > 예시) https://api.neople.co.kr/cy/multi/battleitems?itemIds=667bf72c1b19c325c71e2d978572bd0c,2dcbc863a207ebc15d5b01c1ffe0c19f 요청변수|하위변수|유형|설명|필수여부|기본값 -----|----|--------|------------|--------- itemIds||String|아이템 고유 코드<br>쉼표(,)를 통한 구분 값 처리|Y|
• 11. 캐릭터 정보 /cy/characters  
  Request URL

  요청

  Response Preview

  Response Body

  ## 참고 사항 > 캐릭터 이미지 URL : https://img-api.neople.co.kr/cy/characters/&#60;characterId>?zoom=&#60;zoom><br> ※ zoom 요청 변수를 통해서 1 ~ 3까지 사이즈 조절 가능합니다. 요청변수|하위변수|유형|설명|필수여부|기본값|최대값 -----|----|--------|------------|---------|--------- ||||||
• 12. 포지션 특성 조회 /cy/position-attributes/:attributeId  
  Request URL

  요청

  Response Preview

  Response Body

  ## 참고 사항 > 포지션 특성 이미지 URL : https://img-api.neople.co.kr/cy/position-attributes/&#60;attributeId><br> 요청변수|하위변수|유형|설명|필수여부|기본값|최대값 -----|----|--------|------------|---------|--------- attributeId||String|포지션 특성 고유 코드|Y||