사이퍼즈 API Docs
닉네임, 아이템, 캐릭터, 게임 기록 정보 등
개발에 필요한 다양한 사이퍼즈 API를 제공하고 있습니다.
이용 가능한 오픈 API를 확인하고 나만의 서비스를 만들어 보세요!
- 홈 > API Docs > 사이퍼즈
현재 제공하고 있는 사이퍼즈 오픈 API 목록입니다.
-
요청변수 유형 설명 필수여부 기본값 최대값 nickname String 닉네임 (URL 인코딩 필요) Y wordType String 검색타입
동일 단어(match), 전문 검색(full)
※ full의 경우 최소 2자에서 최대 8자까지 이용 가능match limit Integer 반환 Row 수 10 200 Request URL
-
-
참고 사항
- startDate, endDate 요청 변수 사용 예시
ex) /matches?startDate=20180901T0000&endDate=20180930T2359
/matches?startDate=2018-09-01 00:00&endDate=2018-09-30 23:59
※ 기간 검색 요청 시 하나의 파라미터(startDate, endDate)라도 누락 될 경우 검색이 불가능합니다.
※ 다양한 Date Type을 지원하지만, 상황에 따라 변경될 수 있으므로 예시 Date Type을 이용 부탁드립니다.
※ 초 단위 설정의 경우 startDate : 00초, endDate : 59초로 처리됩니다.
※ 기간 설정은 최대 90일까지 가능합니다. - next 요청변수 사용 예시
ex) /matches?next=<next>&apikey=<apikey>
※ next 사용 시 gameTypeId, limit, startDate, endDate등 요청변수는 최초 조회 기준으로 적용됩니다. - 매칭 기록 갱신 주기
※ 공식 홈페이지 전적 검색과 동일하게 1시간마다 갱신됩니다.
요청변수 유형 설명 필수여부 기본값 최대값 playerId String 플레이어 고유 코드 Y gameTypeId String 게임 타입
rating : 공식전
normal : 일반전rating startDate Date 검색 시작일 현재 시간 기준 30일 전 endDate Date 검색 종료일 현재 시간 limit Integer 반환 Row 수 10 100 next String 다음 데이터 조회 Request URL
- startDate, endDate 요청 변수 사용 예시
-
참고 사항
아이템 이미지 URL : https://img-api.neople.co.kr/cy/items/<itemId>
캐릭터 이미지 URL : https://img-api.neople.co.kr/cy/characters/<characterId>요청변수 유형 설명 필수여부 기본값 matchId String 매칭 고유 코드 Y Request URL
-
요청변수 유형 설명 필수여부 기본값 최대값 playerId String 플레이어 고유 코드 offset Integer 시작 지점 0 limit Integer 반환 Row 수 10 1000 Request URL
-
요청변수 유형 설명 필수여부 기본값 최대값 characterId String 캐릭터 고유 코드 Y rankingType String 랭킹 타입
(승리수: winCount, 승률: winRate, 킬: killCount, 도움: assistCount, 경험치:exp)Y playerId String 플레이어 고유 코드 offset Integer 시작 지점 0 limit Integer 반환 Row 수 10 1000 Request URL
-
요청변수 유형 설명 필수여부 기본값 최대값 tsjType String 투신전 타입
(격: melee, 파: ranged)Y playerId String 플레이어 고유 코드 offset Integer 시작 지점 0 limit Integer 반환 Row 수 10 1000 Request URL
-
참고 사항
아이템 이미지 URL : https://img-api.neople.co.kr/cy/items/<itemId>
요청변수 하위변수 유형 설명 필수여부 기본값 최대값 limit Integer 반환 Row 수 10 100 itemName String 아이템 명칭, URL 인코딩 하여 사용한다 Y wordType String 검색타입
동일 단어(match), 앞 단어 검색(front), 전문 검색(full)
※ full의 경우 최소 2자에서 최대 12자까지 이용 가능match q= characterId String 캐릭터 고유 코드 slotCode String 장착 부위 rarityCode String 아이템 레어리티 seasonCode String 시즌 Request URL
-
참고 사항
아이템 이미지 URL : https://img-api.neople.co.kr/cy/items/<itemId>
요청변수 하위변수 유형 설명 필수여부 기본값 최대값 itemId String 아이템 고유 코드 Request URL
-
참고 사항
아이템 최대 30개 조회 가능합니다.
중복된 아이템 ID 요청 시 중복된 항목은 제거 됩니다.
예시) https://api.neople.co.kr/cy/multi/battleitems?itemIds=667bf72c1b19c325c71e2d978572bd0c,2dcbc863a207ebc15d5b01c1ffe0c19f요청변수 하위변수 유형 설명 필수여부 기본값 itemIds String 아이템 고유 코드
쉼표(,)를 통한 구분 값 처리Y Request URL
-
참고 사항
캐릭터 이미지 URL : https://img-api.neople.co.kr/cy/characters/<characterId>?zoom=<zoom>
※ zoom 요청 변수를 통해서 1 ~ 3까지 사이즈 조절 가능
※ 잘못되었거나 불필요한 요청 변수 추가 시 zoom 요청 변수 기본 값(1) 처리요청변수 하위변수 유형 설명 필수여부 기본값 최대값 Request URL
-
참고 사항
포지션 특성 이미지 URL : https://img-api.neople.co.kr/cy/position-attributes/<attributeId>
요청변수 하위변수 유형 설명 필수여부 기본값 최대값 attributeId String 포지션 특성 고유 코드 Y Request URL
