Changes an article in the authenticated user's stock.
Authentication | Required |
---|---|
Response Format | XML |
HTTP Methods | PUT |
Response Object | Article |
Data Object | Article |
API Version | 1.0 |
https://www.mkmapi.eu/ws/:user/:apikey/stock
None.
Specifies the article to be changed:
<article> <idArticle>89541816</idArticle> <idLanguage>2</idLanguage> <comments>Updated via API</comments> <amount>1</amount> <price>14,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>
While <idArticle /> and <amount /> are the only mandatory tags, all other tags only needs to be provided if its value is changed.
<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).
PUT https://www.mkmapi.eu/ws/someuser/someapikey/stock
<?xml version="1.0" encoding="UTF-8" ?> <request> <article> <idArticle>89541816</idArticle> <idLanguage>2</idLanguage> <comments>Updated via API</comments> <amount>1</amount> <price>14,00</price> </article> </request>
PUT https://www.mkmapi.eu/ws/someuser/someapikey/stock
<?xml version="1.0" encoding="UTF-8" ?> <request> <article> <idArticle>89541816</idArticle> <idLanguage>2</idLanguage> <comments>Updated via API</comments> <amount>2</amount> <price>15,00</price> <condition>EX</condition> </article> </request>