The Media API lets sellers to create, upload, and retrieve files, including:
- images
- videos
- documents for regulations (GPSR regulations)
- documents for post-order activities (such as returns)
image
| Method Name | HTTP Method | Path | Summary | Samples |
|---|---|---|---|---|
| createImageFromFile | POST | /image/create_image_from_file | Creates an eBay Picture Services (EPS) image by uploading a file using multipart/form-data. | View createImageFromFile - /image/create_image_from_file |
| createImageFromUrl | POST | /image/create_image_from_url | Creates an eBay Picture Services (EPS) image from the specified URL. | View createImageFromUrl - /image/create_image_from_url |
| getImage | GET | /image/{image_id} | Retrieves the details of a specified image. | View getImage - /image/{image_id} |
video
| Method Name | HTTP Method | Path | Summary | Samples |
|---|---|---|---|---|
| createVideo | POST | /video | Provides metadata for a video that will be uploaded via uploadVideo. | View createVideo - /video |
| getVideo | GET | /video/{video_id} | Retrieves the details for a specified video. | View getVideo - /video/{video_id} |
| uploadVideo | POST | /video/{video_id}/upload | Uploads a video based on a provided video input source file and video ID. | View uploadVideo - /video/{video_id}/upload |
document
| Method Name | HTTP Method | Path | Summary | Samples |
|---|---|---|---|---|
| createDocument | POST | /document | Creates a document ID with metadata that is used to upload a document file. | View createDocument - /document |
| createDocumentFromUrl | POST | /document/create_document_from_url | Downloads a document from the provided URL and adds the document to the user's account. | View createDocumentFromUrl - /document/create_document_from_url |
| getDocument | GET | /document/{document_id} | Retrieves the details and status of the specified document. | View getDocument - /document/{document_id} |
| uploadDocument | POST | /document/{document_id}/upload | Uploads the document file associated with the specified document ID. | View uploadDocument - /document/{document_id}/upload |
post_order
| Method Name | HTTP Method | Path | Summary | Samples |
|---|---|---|---|---|
| downloadPostOrderDocument | GET | /post_order/document/{document_id} | Downloads a post-order document. | View downloadPostOrderDocument - /post_order/document/{document_id} |
| removePostOrderDocument | DELETE | /post_order/document/{document_id} | Deletes a post-order document. | View removePostOrderDocument - /post_order/document/{document_id} |
| uploadPostOrderDocument | POST | /post_order/document | Uploads a document for use by post-order processes. | View uploadPostOrderDocument - /post_order/document |