POST stock

Adds an article to the authenticated user's stock. The new article is specified by the data.

Resource Information

Authentication	Required
Response Format	XML
HTTP Methods	POST
Response Object	Article
Data Object	Article
API Version	1.0

Resource URL

https://www.mkmapi.eu/ws/:user/:apikey/stock

Parameters

None.

Data

Specifies the article to be added:

<article>
    <idProduct>240357</idProduct>
    <language>1</language>
    <comments>Inserted via API</comments>
    <amount>1</amount>
    <price>99,00</price>
    <condition />        // Condition of the article (if applicable)
    <isFoil />           // Flag, if the article is foil (see notes)
    <isSigned />         // Flag, if the article is signed (see notes)
    <isAltered />        // Flag, if the article is altered (see notes)
    <isPlayset />        // Flag, if the article is offered as playset (see notes)
    <isFirstEd />        // Flag, if the article is first edition (see notes)
</article>

<condition>, <isFoil>, <isSigned>, <isAltered>, <isPlayset>, and <isFirstEd> are all optional data. They are only valid for single cards and cards from particular games (like described in the Article entity).

Default values (when not passed):

• Condition: "NM"; allowed values: "MT", "NM", "EX", "GD", "LP", "PL", "PO"
• All is-Flags: false; allowed values: "true", "false"

Example Requests

POST https://www.mkmapi.eu/ws/someuser/someapikey/stock

<?xml version="1.0" encoding="UTF-8" ?>
<request>
    <article>
    	<idProduct>240357</idProduct>
        <language>1</language>
        <comments>Inserted via API</comments>
        <amount>1</amount>
        <price>99,00</price>
    </article>
</request>

POST https://www.mkmapi.eu/ws/someuser/someapikey/stock

<?xml version="1.0" encoding="UTF-8" ?>
<request>
    <article>
    	<idProduct>3</idProduct>
        <language>2</language>
        <comments>Inserted via API</comments>
        <amount>1</amount>
        <price>0,20</price>
        <isFoil>true</isFoil>
    </article>
</request>