Upload a photo

Adds the photo to the authenticated user's list of photos. These photos can be used when selling.

Our photo retention policy is as follows:

Photos that were uploaded less than 10 days ago are not eligible for deletion.
Photos that are used in an active listing are not eligible for deletion.
Photos that were used in an auction that closed less than 45 days ago are not eligible for deletion.

All other photos may be deleted at our discretion.

It is recommended that a new photo be uploaded whenever you create a new listing. If you are relisting then uploading a new photo is not required, since you cannot relist a listing that closed more than 45 days ago.

URL:	https://api.trademe.co.nz/v1/Photos/Add.{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

file_format

Enumeration (required)

The format of the response.

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

POST Data

PhotoData	String (required)	The actual image data which is base64 encoded.
FileName	String (required)	A textual label for the image, which is intended to make it easier for the user to find the photo when creating a listing. If the file name looks like a path (with forward slash or backslash characters) all characters up to the last slash will be removed. The following characters are not allowed: " < > \|
FileType	String (required)	The file type of the image ("BMP", "GIF", "JPG", "JPEG" or "PNG"). Case is ignored.

Returns

The ID of the added photo.

Status

Enumeration

The status of the photo operation.

Failure	0	The photo action was a failure.
Success	1	The photo action was a success.
NotMemberPhoto	2	The photo is not owned by the member.
NotMemberAuction	3	The auction is not owned by the member.
NotFound	4	The auction was not found.

PhotoId

Long Integer

The ID of the photo.

PhotoUrls

<PhotoUrl> or null

When uploading a new photo, contains a collection of URLs for this photo, one for each size.

Thumbnail	String or null	The URL for the thumbnail sized photo (always 85x64, with white borders).
List	String or null	The URL for the list view sized photo (scaled down to fit 160x120).
Medium	String or null	The URL for the medium sized photo (scaled down to fit 175x175).
Gallery	String or null	The URL for the gallery sized photo (scaled down to fit 233x176).
Large	String or null	The URL for the large sized photo (scaled down to fit 352x264).
FullSize	String or null	The URL for the full sized photo (scaled down to fit 670x502).
PlusSize	String or null	The URL for the plus sized photo (scaled down to fit).
PhotoId	Long Integer	The ID of the photo.

Examples

Upload a tiny skull picture (under the name 'skull.png'):

<PhotoUploadRequest xmlns="http://api.trademe.co.nz/v1">
  <PhotoData>iVBORw0KGgoAAAANSUhEUgAAABkAAAAUCAMAAABPqWaPAAAABGdBTUEAALGPC/xhBQAAAapQTFRFJls2TLtsNnpJR7JnO7piEycYLKlVP6lfPJdXULdtDy0YRaZiNb1hOsNmCyMTChYNAgcDCykUQsRsN8JkRJJZRKpiChgPNoxPSKBhTqpoV7ZwSq5oDBwRR7VoAwYERbtpSK1lOMNlJIREQKxiETkeL5pSQsVrIXk+BRAJFTUeQbdlRL9qJ2A3Pp9bMJtTO6RcNYhOJolGKo9LK3JBM39KJGg5J3hBKXxDMbRdSMlxDSoWR8lvK51RGlUtK3RBHFkvOr9kRcluOalcH2A0N7dfKHdBTMpzE0YlQMVtDCkVH10zCBsOAQIBHUoqBRAIOJ9YN6ZaO7NhGUcnFVssLHhDCxsQGVMrHlkxTsp2U8x6PcRpU8x5ETseM8FhOqdcP7BiDSMTP79oCyETBhULBQ0HTcBzH1EwP7llETEaNqtbP8VrXM+BAQMCCxsRRsdwVMx8Xs+CDSsXLphPOLxiIlc0RMVvAwoFEzceUK5vMptUVcx7Ws6AIU0vETUcIFw0NIdPOoxVK2c/Cx8SEysbPbFhQqZgQbFjPsRqPMRoCRoPUst6Tsp1HWg2AAAASRMimgAAAMxJREFUKM9j6MUFGIiQaW5sqK9rwiJTU1Fd1V1aWYshU5KfXdCVl9VRXI4mk5vaFRndHRWbmF5UhiqTFuFmae3o4BIYn1mIKhPu0d6upq3V5hQQl4Eq427Ro8QiL9tq6uyfgCpjpd7by8cuLtbb6+qHKqOhKijAxcgtI6dp5oMqo9LBwybEwMQpIarnjSpjpCjM28LPKiWtbxOMKuNp2NPSxiEiaWDfk4weOp3KzAqtunZYws3LWMfE3DYkBVOmM9Q3KCwmKYek+CFeBgAPC+wcLxZW8wAAAABJRU5ErkJggg==</PhotoData>
  <FileName>kev.jpeg</FileName>
  <FileType>JPEG</FileType>
</PhotoUploadRequest>

Example XML Request (switch to JSON)

<PhotoUploadRequest xmlns="http://api.trademe.co.nz/v1">
  <PhotoData>ABC</PhotoData>
  <FileName>ABC</FileName>
  <FileType>ABC</FileType>
</PhotoUploadRequest>

Example JSON Request (switch to XML)

{
  "PhotoData": "ABC",
  "FileName": "ABC",
  "FileType": "ABC"
}

Example XML Response (switch to JSON)

<PhotoResponse xmlns="http://api.trademe.co.nz/v1">
  <Status>Failure</Status>
  <PhotoId>123</PhotoId>
  <PhotoUrls>
    <Thumbnail>ABC</Thumbnail>
    <List>ABC</List>
    <Medium>ABC</Medium>
    <Gallery>ABC</Gallery>
    <Large>ABC</Large>
    <FullSize>ABC</FullSize>
    <PlusSize>ABC</PlusSize>
    <PhotoId>123</PhotoId>
  </PhotoUrls>
</PhotoResponse>

Example JSON Response (switch to XML)

{
  "Status": 0,
  "PhotoId": 123,
  "PhotoUrls": {
    "Thumbnail": "ABC",
    "List": "ABC",
    "Medium": "ABC",
    "Gallery": "ABC",
    "Large": "ABC",
    "FullSize": "ABC",
    "PlusSize": "ABC",
    "PhotoId": 123
  }
}