MapleStory.OpenAPI 2.6.1

.NET 6.0 This package targets .NET 6.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package MapleStory.OpenAPI --version 2.6.1
                    


                    

                
NuGet\Install-Package MapleStory.OpenAPI -Version 2.6.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="MapleStory.OpenAPI" Version="2.6.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="MapleStory.OpenAPI" Version="2.6.1" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="MapleStory.OpenAPI" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add MapleStory.OpenAPI --version 2.6.1
                    


                    

                
#r "nuget: MapleStory.OpenAPI, 2.6.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package MapleStory.OpenAPI@2.6.1
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=MapleStory.OpenAPI&version=2.6.1
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=MapleStory.OpenAPI&version=2.6.1
                    


                            Install as a Cake Tool

MapleStory OpenAPI C# Library

NuGet C#

넥슨의 MapleStory OpenAPI를 C# 환경에서 사용할 수 있게 해주는 라이브러리입니다.

다른 언어로 작성된 패키지는 여기에서 확인할 수 있습니다.

(English document is HERE)

Installation

NuGet 기반 프로젝트에 아래 정보를 입력하여 패키지를 추가하세요:

dotnet add package MapleStory.OpenAPI

Usage

API Key

라이브러리를 사용하기 전에 Nexon Open API 콘솔에서 애플리케이션을 등록하고 api key를 발급 받으세요.

Sample Code

아래 코드는 닉네임을 바탕으로 특정 캐릭터의 식별자를 조회한 후 캐릭터의 기본 정보를 조회하는 예시입니다.

using MapleStory.OpenAPI;

var apiKey = "{Your API Key}";
var api = new MapleStoryAPI(apiKey);

// run your code
try
{
    var character = await api.GetCharacter("{Your Character Name}");
    var characterBasic = await api.GetCharacterBasic(character.OCID);

    Console.WriteLine(characterBasic.ToJson());
}
// exception handling
catch (MapleStoryAPIException e)
{
    // handle MapleStoryApiException
}
catch (HttpRequestException e)
{
    // handle HttpRequestException
}

더 많은 예시는 아래 링크의 테스트 케이스에서 확인할 수 있습니다.

Exception Handling

MapleStory OpenAPI 가이드에 서술된 에러 사유를 MapleStoryAPIException를 통해 예외 처리 해야합니다.

MapleStoryAPI는 특정 상태의 예외를 발생시키지 않도록 설계되었으나, 라이브러리를 사용하는 개발자의 실수로 인해 여전히 일부 상태의 예외가 발생할 수 있습니다.

따라서 아래 표에 설명된 MapleStoryAPIErrorCode 목록을 기반으로 MapleStoryAPIException를 예외 처리하시기 바랍니다.

ErrorCode Description
OPENAPI00001 서버 내부 오류
OPENAPI00002 권한이 없는 경우
OPENAPI00003 유효하지 않은 식별자
OPENAPI00004 파라미터 누락 또는 유효하지 않음
OPENAPI00005 유효하지 않은 API KEY
OPENAPI00006 유효하지 않은 API PATH
OPENAPI00007 API 호출량 초과
OPENAPI00009 데이터 준비 중
OPENAPI00010 게임 점검 중
OPENAPI00010 API 점검 중
Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
3.8.1 106 1/24/2026
3.8.0 102 12/31/2025
3.7.0 271 12/18/2025
3.6.0 198 12/4/2025
3.5.1 186 11/22/2025
3.5.0 195 11/4/2025
3.4.1 168 10/24/2025
3.4.0 136 10/18/2025
3.3.0 190 8/21/2025
3.2.1 249 8/8/2025
3.2.0 192 7/17/2025
3.1.0 231 6/19/2025
3.0.0 386 6/12/2025
2.13.1 287 5/12/2025
2.13.0 215 3/29/2025
2.12.1 220 3/20/2025
2.12.0 222 3/20/2025
2.11.0 188 2/21/2025
2.10.0 160 1/17/2025
2.6.1 175 7/8/2024
Loading failed