Returns collection of public URLs. For internal use by Nexway.

File is transferred using multipart/form-data https://www.w3.org/TR/html401/interact/forms.html#h-17.13.4.2 As a result service will return a public https link to resource. File content is used to generate id of the asset, hence files cannot be duplicated. In such case asset is re-uploaded to already existing location. Only one file can be sent at once.

Usage and integration examples

curl

Transfer file from disk

curl -i -X POST \
    https://api.staging.nexway.build/assets \
    -H "Authorization: Bearer ${JWT_TOKEN}" \
    -F file=@"/home/user/Pictures/nexway_main.png"

Transfer using url

curl -i -X POST \
    https://api.staging.nexway.build/assets \
    -H "Authorization: Bearer ${JWT_TOKEN}" \
    -F url="https://www.nexway.com/wp-content/uploads/2019/08/nexway_main.png"

Define file content type

curl -i -X POST \
    https://api.staging.nexway.build/assets \
    -H "Authorization: Bearer ${JWT_TOKEN}" \
    -F file=@"/home//user/Documents/report.csv;type=text/csv"

golang

// Download file from URL
fileResp, _ := http.Get("https://www.nexway.com/wp-content/uploads/2019/08/nexway_main.png")
defer fileResp.Body.Close()

// create multipart form
body := &bytes.Buffer{}
writer := multipart.NewWriter(body)
h := make(textproto.MIMEHeader)
h.Set("Content-Disposition", fmt.Sprintf(`form-data; name="%s"; filename="%s"`, "file", "nexway_main.png"))
h.Set("Content-Type", "image/png")
part, _ := writer.CreatePart(h)
io.Copy(part, fileResp.Body)
writer.Close()

// Execute the request
r, _ := http.NewRequest("POST", "https://api.staging.nexway.build/assets", body)
r.Header.Add("Content-Type", writer.FormDataContentType())
r.Header.Add("Authorization", "Bearer "+os.Getenv("JWT_TOKEN"))
client := &http.Client{}
resp, _ := client.Do(r)

// Results
fmt.Println("Headers", resp.Header)
bodyBytes, _ := ioutil.ReadAll(resp.Body)
fmt.Println("Body", string(bodyBytes))

java

// Create multipart form
File file = new File("/home/user/Pictures/nexway_main.png");
String boundary = "JavaMultiFormBoundary58c6x3GIcM";
HttpEntity reqEntity = MultipartEntityBuilder.create()
  .setBoundary(boundary)
  .addBinaryBody("file", file, ContentType.IMAGE_PNG, "nexway_main.png")
  .build();

// Create post request with form
HttpPost httpPost = new HttpPost("https://api.staging.nexway.build/assets");
httpPost.setHeader("Authorization", "Bearer "+System.getenv("JWT_TOKEN"));
httpPost.setHeader("Content-Type", "multipart/form-data; boundary="+boundary);
httpPost.setEntity(reqEntity);

// Execute request
CloseableHttpClient httpClient = HttpClients.createDefault();
CloseableHttpResponse httpResponse = httpClient.execute(httpPost);
System.out.println("Response: " + httpResponse);
System.out.println("Response Body : " + EntityUtils.toString(httpResponse.getEntity(), "UTF-8"));
httpClient.close();

Only Nexway employee can delete the assets.

Evaluates whether product-related content file is stored in the order.