λ₯μ¨μ MapleStory OpenAPIλ₯Ό Javascript νκ²½μμ μ¬μ©ν μ μκ² ν΄μ£Όλ λΌμ΄λΈλ¬λ¦¬μ λλ€.
λ€λ₯Έ μΈμ΄λ‘ μμ±λ ν¨ν€μ§λ μ¬κΈ°μμ νμΈν μ μμ΅λλ€.
(English document is HERE)
npm κΈ°λ° νλ‘μ νΈμ μλ μ 보λ₯Ό μ λ ₯νμ¬ ν¨ν€μ§λ₯Ό μΆκ°νμΈμ:
npm install maplestory-openapi
λΌμ΄λΈλ¬λ¦¬λ₯Ό μ¬μ©νκΈ° μ μ Nexon Open API μ½μμμ μ ν리μΌμ΄μ μ λ±λ‘νκ³ api keyλ₯Ό λ°κΈ λ°μΌμΈμ.
- CommonJS, ESM μ§μ: μ΄ λΌμ΄λΈλ¬λ¦¬λ CommonJS μ ESM λ°©μμ λͺ¨λ μ§μν©λλ€.
const {MapleStoryApi, MapleStoryApiError} = require('maplestory-openapi'); // CommonJS
import {MapleStoryApi, MapleStoryApiError} from 'maplestory-openapi'; // ESM
- TypeScript μ§μ: νμ μ μκ° ν¬ν¨λμ΄ μμΌλ―λ‘ νμ μ€ν¬λ¦½νΈ νκ²½μμλ μ¬μ© κ°λ₯ν©λλ€.
μλ μ½λλ λλ€μμ λ°νμΌλ‘ νΉμ μΊλ¦ν°μ μλ³μλ₯Ό μ‘°νν ν μΊλ¦ν°μ κΈ°λ³Έ μ 보λ₯Ό μ‘°ννλ μμμ λλ€.
const {MapleStoryApi, MapleStoryApiError} = require('maplestory-openapi');
const apiKey = '{Your API Key}';
const api = new MapleStoryApi(apiKey);
try {
// run your code
const character = await api.getCharacter('{Your Character Name}');
const characterBasic = await api.getCharacterBasic(character.ocid);
console.log(characterBasic);
} catch (e) {
// exception handling
if (e instanceof MapleStoryApiError) {
// handle MapleStoryApiError
} else {
// handle other errors
}
}
λ λ§μ μμλ μλ λ§ν¬μ ν μ€νΈ μΌμ΄μ€μμ νμΈν μ μμ΅λλ€.
- μΊλ¦ν° μ 보 μ‘°ν
- μ λμ¨ μ 보 μ‘°ν
- κΈΈλ μ 보 μ‘°ν
- νλ₯ μ 보 μ‘°ν
- λνΉ μ 보 μ‘°ν
MapleStory OpenAPI κ°μ΄λμ μμ λ μλ¬ μ¬μ λ₯Ό MapleStoryApiError
λ₯Ό ν΅ν΄ μμΈ μ²λ¦¬ ν΄μΌν©λλ€.
MapleStoryApi
λ νΉμ μνμ μμΈλ₯Ό λ°μμν€μ§ μλλ‘ μ€κ³λμμΌλ, λΌμ΄λΈλ¬λ¦¬λ₯Ό μ¬μ©νλ κ°λ°μμ μ€μλ‘ μΈν΄ μ¬μ ν μΌλΆ μνμ μμΈκ° λ°μν μ μμ΅λλ€.
λ°λΌμ μλ νμ μ€λͺ
λ MapleStoryApiErrorCode
λͺ©λ‘μ κΈ°λ°μΌλ‘ MapleStoryApiError
λ₯Ό μμΈ μ²λ¦¬νμκΈ° λ°λλλ€.
ErrorCode | Description |
---|---|
OPENAPI00001 | μλ² λ΄λΆ μ€λ₯ |
OPENAPI00002 | κΆνμ΄ μλ κ²½μ° |
OPENAPI00003 | μ ν¨νμ§ μμ μλ³μ |
OPENAPI00004 | νλΌλ―Έν° λλ½ λλ μ ν¨νμ§ μμ |
OPENAPI00005 | μ ν¨νμ§ μμ API KEY |
OPENAPI00006 | μ ν¨νμ§ μμ API PATH |
OPENAPI00007 | API νΈμΆλ μ΄κ³Ό |
OPENAPI00009 | λ°μ΄ν° μ€λΉ μ€ |
OPENAPI00010 | κ²μ μ κ² μ€ |
OPENAPI00011 | API μ κ² μ€ |