Buy advertisement feature

You can buy features for an advertisement by doing performing POST against the buy feature controller resource. Buying features for an advertisement is only possible when the authenticated user owns the advertisement.

field type constraints Req W U
orderId int no yes no
pay boolean yes yes no

orderId

Optional argument that when specified indicates that these products should be added to an existing order rather than that a new order should be created (not yet implemented)

pay

When set to true indicates that you want to immediately pay for the order via invoicing (only API partners can do this) ONLY TRUE IS CURRENTLY SUPPORTED

Reference

POST /v1/advertisements/{itemId}/features/{featurename}/buy-feature

Purchase a feature

Example

Buying a topadvertentie :

Request :

POST /v1/advertisements/m1/features/topadvertentie/buy-feature HTTP/1.1
Host: api.marktplaats.nl
Content-Type: application/json

{
    "pay": true
}

Response :

HTTP/1.1 201 Created
Location: https://api.marktplaats.nl/v1/orders/123
Content-Location: https://api.marktplaats.nl/v1/orders/123
Content-Type: application/json

{
 "_links": {
    "self": { "href": "/v1/orders/123" },
    "curies": [
      {
        "name": "mp",
        "href": "https://api.marktplaats.nl/docs/v1/{rel}.html",
        "templated": true
      }
    ]
 },
 "_embedded": {
   "mp:product": [
     {
       "_links": {
          "self": { "href": "/v1/orders/123/products/2432" }
       },
       "productId": "2432",
       "description": "topadvertentie",
       "price": "3000"
     }
   ]
 },
 "orderId": 123,
 "status": "paid",
 "price": 3000
}

Errors

http error code description
400 feature-not-allowed The given feature cannot be bought by the current user. This is usually because the feature requires special privileges. If you think you really need this feature, contact us for more information.
400 invalid-feature-type The provided feature type is invalid
400 invalid-order-state The provided order cannot be modified
403 unauthorized The action you are trying to perform is not allowed
400 unknown-order The provided order id is unknown