MapleStory.OpenAPI 2.2.0

MapleStory OpenAPI C# Library

This C# library enables the use of the MapleStory OpenAPI of Nexon.

Packages written in other languages can be found HERE.

(한국어 문서는 이쪽입니다.)

Installation

Install the latest version of the C# library in your NuGet project:

<PackageReference Include="MapleStory.OpenAPI" Version="2.2.0" />

Usage

API Key

Before using the library, register your application and obtain an api key from the Nexon Open API Console.

Sample Code

using MapleStory.OpenAPI;

var apiKey = "{Your API Key}";
var api = new MapleStoryAPI(apiKey);
var dateTimeOffset = new DateTimeOffset(2023, 10, 15, 0, 0, 0, TimeSpan.FromHours(9));

// run your code
try
{
    var response = await api.GetCubeHistory(1000, dateTimeOffset);

    var count = response.Count;
    var cubeHistory = response.CubeHistory;
    var nextCursor = response.NextCursor;

    Console.WriteLine("You used " + count + " cubes.");
}
// exception handling
catch (MapleStoryAPIException e)
{
    // handle MapleStoryApiException
}
catch (HttpRequestException e)
{
    // handle HttpRequestException
}

Exception Handling

Handle MapleStoryAPIException to safely make calls, ensuring that specific Status defined in the MapleStory OpenAPI Guide are not encountered.

While MapleStoryAPI is designed to prevent the occurrence of certain Status, exceptions may arise due to developer mistakes.

Therefore, it's recommended to use MapleStoryAPIException for exception handling based on the MapleStoryAPIErrorCode list described in the table below.