Découvrez comment utiliser notre api de génération de vidéos
GET https://prod.api.clip-it.io/api/v1/templates
Paramètres :
Réponse :
{
"templates": [
{
"template_name": "Template name",
"id_template": 1,
"number_of_product": 3,
"path_preview": "s3://clip-it-customer.s3.amazonaws.com/Customer/Compo-name/preview_name.mp4",
"path_thumbnail": "s3://clip-it-customer.s3.amazonaws.com/Customer/Compo-name/thumbnail_name.jpg",
"click_link_number": 4,
"available_formats": [
"html5",
"1920x1080"
],
"needed_fields": [
{
"formats": [
"1920x1080",
"html5"
],
"click_solids": [
"ClickHTML1",
"ClickHTML2",
"ClickHTML3",
"ClickHTML4"
],
"fields": [
{
"field_needed": "campaign.campaignDate",
"type": "data",
"property": "Source Text"
}
]
}
]
}
]
}
POST https://prod.api.clip-it.io/api/v1/jobs
Paramètres :
Champs du corps de la requête :
Requête :
"template": {
"id": 3,
"formats": [
"html5",
"1920x1080"
],
"html_max_size_kb": 1000,
"click_links": {
"ClickHTML1": "https://www.google.com",
"ClickHTML2": "https://www.google.com",
"ClickHTML3": "https://www.google.com",
"ClickHTML4": "https://www.google.com"
}
},
"webhook": "https://webhook.site/3a383131-2f94-49b8-8dc0-4b3369a2d16b",
"video_name": "video_test_3Produits",
"campaign": {
"campaignTechTitle": "",
"campaignTitle": "Nom de\rl’opération",
"campaignMainImage": "",
"campaignDate": "Du 16 au 19 décembre 2022",
"campaignImageLogoRetailer": "s3://clip-it-dev-customer.s3.amazonaws.com/test/Compo - 3 produits/sources/Logo.png",
"campaignNameRetailer": "Test local repiq test",
"campaignAdressRetailer": ""
},
"products": [
{
"productImageMacaronPromo1": "s3://clip-it-dev-customer.s3.amazonaws.com/test/Compo - 3 produits/sources/Ecouteurs prix.png",
"productImageMacaronPromo2": "",
"productImageMacaronPromo3": "",
"productInitialPriceUnit": "0.0",
"productInitialPriceDecimal": "0.0",
"productDiscountedPriceUnit": "00",
"productDiscountedPriceDecimal": ".00",
"productPromoType": "",
"productPromoLabel": "",
"productPromoDiscountAmount": "00",
"productPromoDiscountPercentage": "00",
"productTitle": "Nom produit 1",
"productBrand": "MARQUE 1",
"productDescription1": "Description produit1\rDescription produit1\rDescription produit1\rDescription produit1",
"productDescription2": "",
"productDescription3": "",
"productLegalNotice": "",
"productMainImage": "s3://clip-it-dev-customer.s3.amazonaws.com/test/Compo - 3 produits/sources/07613035009301-a1l1-s58-removebg-preview.png",
"productImage": "",
"productPicto": "",
"productLogo": "",
"productCategory": "",
"productSubCategory": "",
"productMandateStartDate": "",
"productMandateEndDate": "",
"productEcommerceURL": "",
"productEcatalogURL": "",
"productContentPatternURL": ""
},
{
"productImageMacaronPromo1": "s3://clip-it-dev-customer.s3.amazonaws.com/test/Compo - 3 produits/sources/Frites prix.png",
"productImageMacaronPromo2": "",
"productImageMacaronPromo3": "",
"productInitialPriceUnit": "0.0",
"productInitialPriceDecimal": "0.0",
"productDiscountedPriceUnit": "00",
"productDiscountedPriceDecimal": ".00",
"productPromoType": "",
"productPromoLabel": "",
"productPromoDiscountAmount": "00",
"productPromoDiscountPercentage": "00",
"productTitle": "Nom produit 2",
"productBrand": "MARQUE 2",
"productDescription1": "Description produit2\rDescription produit2\rDescription produit2\rDescription produit2",
"productDescription2": "",
"productDescription3": "",
"productLegalNotice": "",
"productMainImage": "s3://clip-it-dev-customer.s3.amazonaws.com/test/Compo - 3 produits/sources/3560070369690-0-removebg-preview.png",
"productImage": "",
"productPicto": "",
"productLogo": "",
"productCategory": "",
"productSubCategory": "",
"productMandateStartDate": "",
"productMandateEndDate": "",
"productEcommerceURL": "",
"productEcatalogURL": "",
"productContentPatternURL": ""
},
{
"productImageMacaronPromo1": "s3://clip-it-dev-customer.s3.amazonaws.com/test/Compo - 3 produits/sources/Lessive Prix.png",
"productImageMacaronPromo2": "",
"productImageMacaronPromo3": "",
"productInitialPriceUnit": "0.0",
"productInitialPriceDecimal": "0.0",
"productDiscountedPriceUnit": "00",
"productDiscountedPriceDecimal": ".00",
"productPromoType": "",
"productPromoLabel": "",
"productPromoDiscountAmount": "00",
"productPromoDiscountPercentage": "00",
"productTitle": "Nom produit 3",
"productBrand": "MARQUE 3",
"productDescription1": "Description produit3\rDescription produit3\rDescription produit3\rDescription produit3",
"productDescription2": "",
"productDescription3": "",
"productLegalNotice": "",
"productMainImage": "s3://clip-it-dev-customer.s3.amazonaws.com/test/Compo - 3 produits/sources/03252210490110-h1l1-s02-removebg-preview.png",
"productImage": "",
"productPicto": "",
"productLogo": "",
"productCategory": "",
"productSubCategory": "",
"productMandateStartDate": "",
"productMandateEndDate": "",
"productEcommerceURL": "",
"productEcatalogURL": "",
"productContentPatternURL": ""
}
]
}
Réponse :
{
"uid": "string",
"state": "string",
"format": "string",
"child_jobs": [
{
"uid": "string",
"state": "string",
"format": "string",
"video_s3_path": "string",
"after_project_path": "string"
}
],
"video_s3_path": "string",
"after_project_path": "string",
"video_name": "string",
"renderProgress": 0,
"error": {},
"createdAt": "string",
"startedAt": "string",
"finishedAt": "string"
}
GET https://prod.api.clip-it.io/api/v1/jobs/status
Paramètres :
Réponse :
[
{
"uid": "string",
"state": "string",
"format": "string",
"child_jobs": [
{
"uid": "string",
"state": "string",
"format": "string",
"video_s3_path": "string",
"after_project_path": "string"
}
],
"video_s3_path": "string",
"after_project_path": "string",
"video_name": "string",
"renderProgress": int,
"error": string || null,
"webHookURL": string || null,
"execNumber": int,
"videoDuration": int,
"createdAt": "string",
"startedAt": "string",
"finishedAt": "string"
}
]
GET https://prod.api.clip-it.io/api/v1/jobs/{uid}/status
Paramètres :
Réponse :
{
"uid": "string",
"state": "string",
"format": "string",
"child_jobs": [
{
"uid": "string",
"state": "string",
"format": "string",
"video_s3_path": "string",
"after_project_path": "string"
}
],
"video_s3_path": "string",
"after_project_path": "string",
"video_name": "string",
"renderProgress": int,
"error": string || null,
"webHookURL": string || null,
"execNumber": int,
"videoDuration": int,
"createdAt": "string",
"startedAt": "string",
"finishedAt": "string"
}
GET https://prod.api.clip-it.io/api/v1/jobs/health
Paramètres :
Réponse :
ok