mschadev / kartrider-open-api-docs Goto Github PK

View Code? Open in Web Editor NEW

10.0 1.0 2.0 92 KB

넥슨 개발자 센터 카트라이더 OPEN API의 보충 문서입니다.

kartrider nexon api-docs metadata

kartrider-open-api-docs's People

Contributors

Stargazers

Watchers

Forkers

jmlee0415 huhani

kartrider-open-api-docs's Issues

프로토 바이크 V1 빈문자열로 표시됨

Authorization(키값)은 쓰지마세요.

정보
발생한 시간: 프로토 바이크 V1 출시 후
API URL: Any
API Query: Any

문제

유저 고유 식별자로 매치 리스트 조회

{
  "accountNo": "117717532",
  "matchId": "017c001101d065ec",
  "matchType": "effd66758144a29868663aa50e85d3d95c5bc0147d7fdb9802691c2087f3416e",
  "teamId": "1",
  "character": "2ecb10f5e23493727a80a91421d6242a18b131f743676e72317bde4bd5d27131",
  "startTime": "2022-07-21T06:39:25",
  "endTime": "2022-07-21T06:41:13",
  "channelName": "speedTeamCombine",
  "trackId": "73103a17062d7007e64739fefc2aee4ba0d98baa53c1f9b7bd5320202b0eff75",
  "playerCount": 2,
  "matchResult": "1",
  "seasonType": "",
  "player": {
    "accountNo": "",
    "characterName": "",
    "character": "2ecb10f5e23493727a80a91421d6242a18b131f743676e72317bde4bd5d27131",
    "kart": "",
    "license": "",
    "pet": "",
    "flyingPet": "a87cb96d91a4e0c357c4eaeb7dbc05ef515d183e79a8aa0e674c36f917400a4b",
    "partsEngine": "",
    "partsHandle": "",
    "partsWheel": "",
    "partsKit": "",
    "rankinggrade2": "5",
    "matchRank": "1",
    "matchRetired": "0",
    "matchWin": "1",
    "matchTime": "88054"
  }
}

특정 매치의 상세 정보 조회

{
        "channelName": "speedTeamCombine",
        "startTime": "2022-07-21T06:39:25.905000",
        "endTime": "2022-07-21T06:41:13.160000",
        "gameSpeed": 7,
        "matchId": "017c001101d065ec",
        "matchResult": "1",
        "matchType": "effd66758144a29868663aa50e85d3d95c5bc0147d7fdb9802691c2087f3416e",
        "playTime": 98,
        "trackId": "73103a17062d7007e64739fefc2aee4ba0d98baa53c1f9b7bd5320202b0eff75",
        "teams": [
                {
                        "teamId": "2",
                        "players": [
                                {
                                        "accountNo": "302575272",
                                        "characterName": "TTEESSTT",
                                        "character": "2ecb10f5e23493727a80a91421d6242a18b131f743676e72317bde4bd5d27131",
                                        "kart": "b60655326fe02092eb7fc61e2c37549e97132d7967826542a6d3fd683223cb20",
                                        "license": "",
                                        "pet": "",
                                        "flyingPet": "13e247466d75204e1b3d587abcc11def087f6ffcdfcf798cb2c4b8edcddd8f5b",
                                        "partsEngine": "0",
                                        "partsHandle": "0",
                                        "partsWheel": "0",
                                        "partsKit": "0",
                                        "rankinggrade2": "0",
                                        "matchRank": "99",
                                        "matchRetired": "1",
                                        "matchWin": "0",
                                        "matchTime": ""
                                }
                        ]
                },
                {
                        "teamId": "1",
                        "players": [
                                {
                                        "accountNo": "117717532",
                                        "characterName": "extern",
                                        "character": "2ecb10f5e23493727a80a91421d6242a18b131f743676e72317bde4bd5d27131",
                                        "kart": "",
                                        "license": "",
                                        "pet": "",
                                        "flyingPet": "a87cb96d91a4e0c357c4eaeb7dbc05ef515d183e79a8aa0e674c36f917400a4b",
                                        "partsEngine": "",
                                        "partsHandle": "",
                                        "partsWheel": "",
                                        "partsKit": "",
                                        "rankinggrade2": "5",
                                        "matchRank": "1",
                                        "matchRetired": "0",
                                        "matchWin": "1",
                                        "matchTime": "88054"
                                }
                        ]
                }
        ]
}

일부 닉네임에서 한글이 물음표로 출력되는 문제

Authorization(키값)은 쓰지마세요.

정보
발생한 시간:
API URL: https://api.nexon.co.kr/kart/v1.0/users/1443140446
API Query:

문제

닉네임이 물음표로 뜨는 문제가 있는데, 한글 처리가 제대로 되지 않아 물음표가 뜨는 것으로 파악됨.

accessId	잘못된 닉네임	실제 닉네임
1292107586	??1156	빤쯔1156
889236035	??12	동원12
956864529	??12	노번12
1879195116	??12	병학12
1091104125	??123	븍이123
2097310820	??128128	나라128128
67368055	??13	짜증13
939656664	??1323	노아1323
1308623871	??1?1?	넌미1친1놈
1208077512	??1??	세계1위당
772052317	??1qkdrk	방가1qkdrk
1509979653	???	조커닝
922792119	????	천재훈우

유저 고유 식별자로 매치 리스트 조회시 matchRetired가 항상 0임

Authorization(키값)은 쓰지마세요.

정보
발생한 시간: 2021-01-12 16:26
API URL: https://api.nexon.co.kr/kart/v1.0/users/{access_id}/matches?start_date={start_date}&end_date={end_date} &offset={offset}&limit={limit}&match_types={match_types}
API Query: 117717532/matches?start_date=&end_date= &offset=0&limit=10&match_types=
모든 쿼리에 대해 항상 0을 출력되는 것으로 짐작됨

문제
유저 고유 식별자로 매치 리스트를 조회했을 시에

 "matches": [
                                {
                                        "accountNo": "117717532",
                                        "matchId": "0b280017cc7b0e70",
                                        "matchType": "effd66758144a29868663aa50e85d3d95c5bc0147d7fdb9802691c2087f3416e",
                                        "teamId": "2",
                                        "character": "48357251a360710371aa5c9f0952ea10ab454feae1d53fcd147980068b33181b",
                                        "matchResult": "0",
                                        "seasonType": "",
                                        "startTime": "2021-01-12T07:16:26",
                                        "endTime": "2021-01-12T07:18:53",
                                        "channelName": "speedTeamFastest",
                                        "trackId": "c8c082b7156e14bb531667b925616f863d9b23e6fbad276936b6a9484c033703",
                                        "playerCount": 8,
                                        "player": {
                                                "accountNo": "",
                                                "characterName": "",
                                                "character": "48357251a360710371aa5c9f0952ea10ab454feae1d53fcd147980068b33181b",
                                                "kart": "826f4a85b74f291472189c317c70155e754875675f30821e74f5124c8dc2bd62",
                                                "license": "",
                                                "pet": "",
                                                "flyingPet": "a87cb96d91a4e0c357c4eaeb7dbc05ef515d183e79a8aa0e674c36f917400a4b",
                                                "partsEngine": "",
                                                "partsHandle": "",
                                                "partsWheel": "",
                                                "partsKit": "",
                                                "rankinggrade2": "5",
                                                "matchRank": "99",
                                                "matchRetired": "0",
                                                "matchWin": "0",
                                                "matchTime": ""
                                        }
                                },

matchRetired가 0임
매치 아이디로 상세 조회를 한다면

  {
                                        "accountNo": "117717532",
                                        "characterName": "Extern",
                                        "character": "48357251a360710371aa5c9f0952ea10ab454feae1d53fcd147980068b33181b",
                                        "kart": "826f4a85b74f291472189c317c70155e754875675f30821e74f5124c8dc2bd62",
                                        "license": "",
                                        "pet": "",
                                        "flyingPet": "a87cb96d91a4e0c357c4eaeb7dbc05ef515d183e79a8aa0e674c36f917400a4b",
                                        "partsEngine": "",
                                        "partsHandle": "",
                                        "partsWheel": "",
                                        "partsKit": "",
                                        "rankinggrade2": "5",
                                        "matchRank": "99",
                                        "matchRetired": "1",
                                        "matchWin": "0",
                                        "matchTime": ""
                                },

matchRetired 값이 정상적으로 출력됨.

특정 시간 이전 스피드 클럽 레이싱은 개인전 구조로 출력됨

Authorization(키값)은 쓰지마세요.

정보
발생한 시간: 2020-12-22 13:44
API URL: https://api.nexon.co.kr/kart/v1.0/matches/{match_id}
API Query: {match_id}가 스피드 클럽 레이싱인 경우
발생한 이후 매치 게임 009c0004644dc7b8
발생한 시간 전 매치 게임 03f50004dbe9a795

문제
발생한 시간 이전에는 개인전 구조로 떴지만, 발생한 시간 이후부터는 팀전 구조로 변경되어 출력됩니다.

※ 개발자 센터 문의에 대한 답변 기반입니다.

X 엔진 이상은 장착된 파츠가 출력되지 않음

Authorization(키값)은 쓰지마세요.

정보
발생한 시간: 처음부터 그랬을거라 짐작됨.
API URL: Any(PlayerDTO가 있는 모든 API)
API Query: Any

문제
X 엔진 이상는 장착된 파츠가 출력되지 않음

gameType.json에 '아이템 팀 개인전'이 있음

정보
발생한 시간: 2020-09-23 23:44(UTC+9)

문제
파일명: gameType.json

{"id":"32f9446c97af9d2d928a16161413b5a500c58304df1bce3ddd94a140335b3348","name":"아이템 팀 개인전"},

access_id가 음수(마이너스) 값이 존재함

문제
accessId 값의 범위가 0 이상의 정수가 아닌 음수의 정수값도 존재함.

유저-정보-조회.md 수정 요망.

일부 트랙이 빈 문자열로 표시됨

Authorization(키값)은 쓰지마세요.

정보
발생한 시간: 2022. 07. 07부터
API URL: https://api.nexon.co.kr/kart/v1.0/matches/ and https://api.nexon.co.kr/kart/v1.0/matches/{match_id}
API Query: 02a8000b65610aa3 and 02b1000b65546b9e

문제

[R]차이나 골목길 대질주(02b1000b65546b9e)
[R]어비스 숨겨진 바닷길(02a8000b65610aa3)

해당 트랙이 진행된 매치는 trackId가 ""로 표시됨

특정 유저의 정보를 가져올 때 레벨이 비정상적으로 출력되는 유저가 있음.

정보
발생한 시간: 2022-01-02 18:25
API URL: 상기 스크린샷에 기재.
API Query: 상기 스크린샷에 기재.

문제
"유저 고유 식별자로 라이더명 조회" 에서 일부 유저들의 level이 이상하게 뜨는 문제 발생.
API를 이용한 실사용때도 동일한 문제 발생함.

유저 정보 API에서 level Key가 항상 0임

Authorization(키값)은 쓰지마세요.

정보
발생한 시간: 2020-09-14 17:16
API URL: https://api.nexon.co.kr/kart/v1.0/users/nickname/{nickname}
API Query: Any

문제
JSON object(root)에서 level 키의 값이 항상 0으로 반환됨

{
        "level": 0
}

카트라이더 서비스 종료로 인한 아카이브

넥슨 개발자 센터의 카트라이더 API는 2023년 4월 3일부로 서비스 하지 않으므로 해당 저장소는 보관처리 됩니다.
고생 많으셨습니다

일부 플레이어 매치 조회시 관련 없는 matchId가 조회됨

Authorization(키값)은 쓰지마세요.

정보
발생한 시간: 2022-07-26 19:47
API URL: https://api.nexon.co.kr/kart/v1.0/users
API Query: 1258773090/matches?start_date=&end_date=&offset=0&limit=20&match_types=

문제
유저 고유 식별자로 매치 리스트 조회해서 나온 데이터
불필요한 데이터들은 삭제함

{
        "matches": [
                {
                        "matches": [
                                {
                                        "accountNo": "1258773090",
                                        "matchId": "0217000a1808df12",
                                        "matchType": "14e772d195642279cf6c8307125044274db371c1b08fc3dd6553e50d76d2b3aa",
                                        "teamId": "1",
                                        "character": "81c9f10de2f39d42f97b206c5804c32495e3f3e751d20529e1ac3c8aeb0a4939",
                                        "startTime": "2022-07-25T14:12:51",
                                        "endTime": "2022-07-25T14:15:00",
                                        "channelName": "itemTeamCombine",
                                        "trackId": "17b524aaf68170df0645c6f9928cfbe2bd7f532b384d99f59e47b2c7c1badb9e",
                                        "playerCount": 8,
                                        "matchResult": "1",
                                        "seasonType": "",
                                        "player": {
                                                "accountNo": "",
                                                "characterName": "",
                                                "character": "81c9f10de2f39d42f97b206c5804c32495e3f3e751d20529e1ac3c8aeb0a4939",
                                                "kart": "24c9029444bfae084b2269d93491999f54436b03e23ecf6082efbd3acb37ce17",
                                                "license": "",
                                                "pet": "",
                                                "flyingPet": "",
                                                "partsEngine": "",
                                                "partsHandle": "",
                                                "partsWheel": "",
                                                "partsKit": "",
                                                "rankinggrade2": "5",
                                                "matchRank": "6",
                                                "matchRetired": "0",
                                                "matchWin": "1",
                                                "matchTime": "114826"
                                        }
                                }
                        ],
                        "matchType": "14e772d195642279cf6c8307125044274db371c1b08fc3dd6553e50d76d2b3aa"
                }
        ],
        "nickName": "이유나들어봐"
}

matchId 0217000a1808df12로 조회시 해당 유저와 전혀 상관없는 매치가 조회됨
데이터들은 정상이지만 matchId만 잘못된 것으로 추정

"특정 매치의 상세 정보 조회" 에서 플레이어 정보가 null로 반환됨

정보
발생한 시간: 2022-01-07 11:23
API URL: https://api.nexon.co.kr/kart/v1.0/matches/002b001341e6ed57
API Query:

문제

유저 정보를 조회할 때 레벨이 실제 게임 내의 레벨보다 더 낮게 출력되는 경우가 발생.

정보
발생한 시간: 2022-01-01 21:40:45
API URL: https://api.nexon.co.kr/kart/v1.0/users/1124686354
API Query:
{ accessId: '1124686354', name: 'Mysticlms', level: 18 }

문제
1124686354 번호 유저의 마지막 레벨 결과 :
{
accountNo: 1124686354,
level: 19,
regdate: 1640876109000
}

사용자 레벨 정보를 업데이트 하기 위해 API 호출 결과, 마지막에 기록한 레벨(2021-12-30 23:55:09)보다 낮게 나옴.
이는 API의 값이 정확하지 않을 수 있음을 의미함.

2021-12-30 23:55:09시점에서 19레벨이었으나, 2022-01-01 21:40:45에선 18레벨로 뜸.

유저정보 API json object에서 새로운 키가 확인됨

Authorization(키값)은 쓰지마세요.

정보
발생한 시간: 2020-09-14 17:08
API URL: https://api.nexon.co.kr/kart/v1.0/users/{access_id},https://api.nexon.co.kr/kart/v1.0/users/nickname/{nickname}
API Query: Any

문제
문서에 추가되지 않은 새로운 키가 확인됨.

{
        "level": 101
}

mschadev / kartrider-open-api-docs Goto Github PK

kartrider-open-api-docs's People

Contributors

Stargazers

Watchers

Forkers

kartrider-open-api-docs's Issues

유저 고유 식별자로 매치 리스트 조회

특정 매치의 상세 정보 조회

Recommend Projects

Recommend Topics

Recommend Org