v2.returns.convert_image
POST /api/v2/returns/convert_image
Convert a specific format and pictures within 10M into url.
Endpoint URL
URL: https://partner.shopeemobile.com/api/v2/returns/convert_image
Common Request Parameters
| Name | Type | Sample | Description |
|---|---|---|---|
| partner_id | int | 1 | Partner ID is assigned upon registration is successful. Required for all requests. |
| timestamp | timestamp | 1610000000 | This is to indicate the timestamp of the request. Required for all requests. Expires in 5 minutes. |
| access_token | string | c09222e3fc40ffb25fc947f738b1abf1 | The token for API access, using to identify your permission to the api. Valid for multiple use and expires in 4 hours. |
| shop_id | int | 600000 | Shopee's unique identifier for a shop. Required param for most APIs. |
| sign | string | e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2 | Signature generated by partner_id, api path, timestamp, access_token, shop_id and partner_key via HMAC-SHA256 hashing algorithm. More details: https://open.shopee.com/documents?module=87&type=2&id=58&version=2 |
Request Parameters
| Name | Type | Required | Sample | Description |
|---|---|---|---|---|
| return_sn | string | True | 220707155172370 | The serial number of return. |
| upload_image | file | True | The proof picture to be uploaded must be within 10MB in size, and the format only supports .jpg, .jpeg, and .png. Only one picture is allowed to be uploaded per request. If multiple pictures are uploaded, only the first picture will be processed. |
Response Parameters
| Name | Type | Sample | Description |
|---|---|---|---|
| request_id | string | openapi-5c30ac4af4a567464b3bcb85f327d0de | The identifier for an API request for error tracking. |
| error | string | Indicate error code if hit error. Empty if no error happened. | |
| message | string | success | Indicate error details if hit error. Empty if no error happened. |
| response | object | ||
| url | string | https://file-proxy.seller.test.shopee.com/api/v2/files/c2hvcGVlLWRyYzAx/6cd5662c25964655827057bb2bfa69e2.png | The link uploaded to the image server can be used with the upload_proof interface. |
| thumbnail | string | https://file-proxy.seller.test.shopee.com/api/v2/files/c2hvcGVlLWRyYzAx/6cd5662c25964655827057bb2bfa69e2.png | The image thumbnail. |