Add a photo to a listing

Adds a photo to an auction. The currently authenticated user must be the seller.

This API can currently only add a single photo to an auction without any photos. It is recommended that photos are instead specified when creating a listing or when using the edit listing API (both APIs can handle multiple photos).

URL:	https://api.trademe.co.nz/v1/photos/{photoId}/Add/{listingId}.{file_format}
HTTP Method:	POST
Requires Authentication?	Yes
Permission Required:	MyTradeMeWrite: Maintain your watchlist, answer questions and post comments.
Supported Formats:	XML, JSON
Rate Limited?	Yes

URL parameters

photoId

Integer (required)

The ID of the photo to add.

listingId

Integer (required)

The ID of the listing to add the photo to.

file_format

Enumeration (required)

The format of the response.

xml	Serialize responses into XML.
json	Serialize responses into JSON.

Returns

The ID of the added photo.

Status

Enumeration

Status

Failure	0	Failure
Success	1	Success
NotMemberPhoto	2	NotMemberPhoto
NotMemberAuction	3	NotMemberAuction
NotFound	4	NotFound

PhotoId

Integer

PhotoId

Description

String or null

Description

Example XML Response (switch to JSON)

<PhotoResponse xmlns="http://api.trademe.co.nz/v1">
  <Status>Failure</Status>
  <PhotoId>123</PhotoId>
  <Description>ABC</Description>
</PhotoResponse>

Example JSON Response (switch to XML)

{
  "Status": 0,
  "PhotoId": 123,
  "Description": "ABC"
}