Upcall confirmations

You can confirm an advertisement upcall by performing a POST against the upcall confirmations controller resource.

Confirming advertisement upcalls is currently restricted to clients authenticating with client credentials. These clients should use a token that has the confirm_upcall scope. Read more about this in the Obtaining an Access Token for a client section of the authentication chapter.

Note

Work in Progress

Fields

field type constraints Req W U
callerPhoneNumber string yes no no
calleePhoneNumber string yes no no
startTime ISO 8601 timestamp yes no no
endTime ISO 8601 timestamp yes no no

callerPhoneNumber

The phone number of the caller.

calleePhoneNumber

The phone number which has been called.

startTime

Time when the call started.

endTime

Time when the call ended.

Reference

POST /v1/advertisements/{itemId}/upcall-confirmations

Confirm an advertisement upcall.

Example

Confirming an upcall for an advertisement with id 1 :

Request :

POST /v1/advertisements/m1/upcall-confirmations HTTP/1.1
Host: api.marktplaats.nl
Content-Type: application/json

{
    "callerPhoneNumber": "0615420879",
    "calleePhoneNumber": "0113293823",
    "startTime": "2014-12-02T09:34:21+00:00",
    "endTime": "2014-12-02T09:34:23+00:00"
}

Response :

HTTP/1.1 201 Created

Errors

http error code description
404 advertisement-not-found The advertisement with the provided itemId does not exist.
500 internal-server-error Oops! Sorry, something went wrong on our side.
403 unauthorized The action you are trying to perform is not allowed.