MapleStory.OpenAPI 1.1.0

MapleStory OpenAPI C# Library

This C# library enables the use of the MapleStory OpenAPI provided by 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="1.1.0" />

Usage

Sample Code

using MapleStory.OpenAPI;

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

// run your code
try
{
    var response = await api.GetCubeResult(1000, 2023, 10, 15);

    var count = response.Count;
    var cubeHistories = response.CubeHistories;
    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 Status list described in the table below.