Add, Edit and Remove Items

It is possible to Add, Edit, and Remove items to, on, resp. from a WantsList. The items can be Product or MetaProduct. When editing (or removing) an item on a WantsList, it is necessary to provide id of the want (idWant) in the request data.

Resource Information

Authentication	Required
Response Format	XML
HTTP Methods	PUT
Response Object	Want
Data Object	Want
API Version	1.0

Resource URL

https://www.mkmapi.eu/ws/:user/:apikey/wantslist/:id

Parameters

id	Mandatory

• id: ID of the WantsList to which wants need to be added/edited/removed.
• Example Value: 100225

Data

Specifies if the items should be added, edited or removed:

<action>add</action>    // Adds the want(s)
<action>edit</action>   // Edits the want(s)
<action>remove</action> // Removes the want(s)

Specifies a Product item to be added to the WantsList:

    
<product>
    <idProduct>92560</idProduct>    // mandatory
    <amount>1</amount>              // mandatory
    <minCondition>MT</minCondition> // mandatory
    <wishPrice>0.45</wishPrice>     // mandatory
    <idLanguage>1</idLanguage>      // one for each language
    <isFoil>true</isFoil>           // optional
    <isSigned>true</isSigned>       // optional
    <isAltered>true</isAltered>     // optional
    <isPlayset>true</isPlayset>     // optional
    <isFirstEd>true</isFirstEd>     // optional
</product>

Specifies a Metaproduct item to be added to the WantsList:

    
<metaproduct>
    <idMetaproduct>81</idMetaproduct> // mandatory
    <amount>1</amount>                // mandatory
    <minCondition>NM</minCondition>   // mandatory
    <wishPrice>0.45</wishPrice>       // mandatory
    <idLanguage>1</idLanguage>        // one for each language
    <isFoil>true</isFoil>             // optional
    <isSigned>true</isSigned>         // optional
    <isAltered>true</isAltered>       // optional
    <isPlayset>true</isPlayset>       // optional
    <isFirstEd>true</isFirstEd>       // optional
</metaproduct>

Specifies a Want item to be edited in the WantsList (regardless if it's a product or metaproduct):

    
<want>
    <idWant>5285ef40ed21897015000000</idWant> // mandatory
    <amount>1</amount>              // optional
    <minCondition>MT</minCondition> // optional
    <wishPrice>0.45</wishPrice>     // optional
    <idLanguage>1</idLanguage>      // one for each language
    <isFoil>true</isFoil>           // optional
    <isSigned>true</isSigned>       // optional
    <isAltered>true</isAltered>     // optional
    <isPlayset>true</isPlayset>     // optional
    <isFirstEd>true</isFirstEd>     // optional
</want>

Specifies an item to be removed from the WantsList:

    
<want>
    <idWant>528398dced2189c813000001</idWant>             
</want>

Example Requests

PUT https://www.mkmapi.eu/ws/someuser/someapikey/wantslist/:id

<?xml version="1.0" encoding="UTF-8" ?>
<request> 
    <action>add</action>   
    <product>
        <idProduct>92560</idProduct>
        <amount>4</amount>
        <minCondition>EX</minCondition>
        <wishPrice>0.45</wishPrice>
        <idLanguage>1</idLanguage>
        <idLanguage>2</idLanguage>  
        <isFoil>true</isFoil>
    </product>
    <metaproduct>
        <idMetaproduct>81</idMetaproduct>
        <amount>2</amount>
        <minCondition>NM</minCondition>
        <wishPrice>5,55</wishPrice>
    </metaproduct>
</request>

PUT https://www.mkmapi.eu/ws/someuser/someapikey/wantslist/:id

<?xml version="1.0" encoding="UTF-8" ?>
<request> 
    <action>edit</action>   
    <want>
        <idWant>52833a9fed2189f810000000</idWant>
        <amount>2</amount>        
    </want> 
</request>

PUT https://www.mkmapi.eu/ws/someuser/someapikey/wantslist/:id

<?xml version="1.0" encoding="UTF-8" ?>
<request> 
    <action>remove</action>   
    <want>
        <idWant>528398dced2189c813000001</idWant>               
    </want> 
</request>