Upload Video
Uploads video file
URL: POST /api/v1/assets/video
Request Parameters
| Parameter | Description | Type | Required | Possible Values |
|---|---|---|---|---|
| advertiserId | The ID of the specific advertiser | integer | Y | A valid advertiser Id |
| videoFile | Path to video file | file | Y | |
| profileName | enum | Y | Required value: checkin | |
| generateCaptions | boolean | Y | True, false (should typically be set to true) |
Video Requirements
File size: 500MB maximum
File type: mp4 or mov
Resolution: 1280x720 to 3840x2160 px, 16:9
Duration: 5-45 seconds
Headers
| Header Name | Description | Required | Values |
|---|---|---|---|
| Authorization | The token will provide you the access to the API. It is same for all advertisers you access through the API. | Y | Please utilize the generated auth_token shared with you at the time of partner onboarding from the Getting Started Guide |
| WM_CONSUMER.ID | We will provide you the consumer ID to access the API. It is same for all advertisers you access through the API. | Y | Please use the generated ConsumerId shared with you at the time of partner onboarding. Refer to the Getting Started Guide for more information |
| WM_SEC.AUTH_SIGNATURE | Auth signature as an API key. | Y | Use the signature generator code from Getting Started Guide to generate this value |
| WM_SEC.KEY_VERSION | We will provide you with the KEY VERSION to access the API. It is same for all advertisers you access through the API. | Y | 1 |
| WM_CONSUMER.intimestamp | Timestamp for which the auth signature is generated. Use Unix epoch format for the timestamp. | Y | Use the signature generator code from Getting Started Guide to generate this value |
Sample Request
curl -X POST \
'https: //developer.api.us.stg.walmart.com/api-proxy/service/display/api/v1/api/v1/assets/video' \ --header 'Content-Type: multipart/form-data'\
--header 'Authorization: Bearer <auth_token>'
--header 'WM_SEC.AUTH_SIGNATURE: **************' \
--header 'WM_SEC.KEY_VERSION: 1' \
--header 'WM_CONSUMER.ID: adfwe-v00-faasd2r-afs-asdfqeff' \
--header 'WM_CONSUMER.intimestamp: 1565309779'\
--header "X-Advertiser-ID: 00000" \
--form "advertiserId=00000" \
--form "videoFile=/pathto/video.mp4" \
--form "profileName=checkin" \
--form "generateCaptions=true"
Response
| Element | Description | Type |
|---|---|---|
| code | The response code can have following values:
Click here for more information about Status Codes and Errors | string |
| details | Possible values of details:
| string |
| assetId | ID of the video asset file. It is returned in response only if code = success | string |
| captioningJobId | ID of the captioning job when generateCaptions = true | string |
Sample Response
{ "code": "success", "details": ["success"], "assetId": uuid, "captioningJobId":uuid
}
Updated 4 days ago