[GUIDE] 5th Job Advancement API

We are announcing the addition of new APIs that will help you create more diverse and engaging services. With this update, you can now retrieve information about a character's Arcane Symbols and their 5th Job Skills (V-Matrix).

Please see below for more details.

1. Retrieve Equipped Arcane Symbol Information

The arcaneSymbols field has been added to the response of the GET /v1rc1/characters/{assetKey}/wearing API.

You can now use this to check the Arcane Symbols a character has equipped.

• Endpoint: GET /v1rc1/characters/{assetKey}/wearing
• Added Field: arcaneSymbols

2. Character 5th Job Skill (V-Matrix) Information APIs

Two new APIs have been added to allow you to retrieve a character's V-Matrix node list and the detailed information for each node.

2-1. Retrieve V-Matrix Node List

• Endpoint: GET /v1rc1/characters/{assetKey}/vmatrix

2-2. Retrieve V-Matrix Node Details

• Endpoint: GET /v1rc1/gamemeta/vmatrix/{nodeId}
• Key Information: You can identify the type of node using the nodeType field. 

⚠️ Important Usage Note for V-Matrix Node Detail API

Please note a critical detail regarding the GET /v1rc1/gamemeta/vmatrix/{nodeId} API.

This API does not retrieve a character's actual skill node data using a single key. Instead, it generates and returns information based on the specific combination of nodeId, level, and skillIdList parameters you provide in the call.

Therefore, to ensure data accuracy, it is essential that you construct the API call using the exact node information retrieved from the GET /v1rc1/characters/{assetKey}/vmatrix API.

Potential Issue Example:

If a character's actual node is a combination of sub-skills (A, B, C), but a builder mistakenly calls the API with a different combination (e.g., A, B, D), the API will return data for the incorrect (A, B, D) combination. This will result in a discrepancy between the data shown in your service and the character's actual in-game data.

Please pay close attention to how you call this API to prevent data inconsistencies

We appreciate your continued commitment to building the MapleStory Universe Ecosystem. 

Thank you.