Links

Banner

Events linked to banners - Abyssale Webhooks

NEW_BANNER

A new banner has been generated. It can be filtered by template.
When a banner is generated synchronously from an API call, this event won't be triggered.

Sample response:

{
"id": "a14e1d26-ff41-47cb-bbf9-8f2d777a5bd7",
"file":
{
"type": "jpeg",
"url": "url/name.jpeg",
"cdn_url": "cdn_url/name.jpeg",
"filename": "name.jpeg"
},
"format":
{
"id": "300x250-medium-rectangle",
"width": 300,
"height": 250
},
"template":
{
"id": "873608a1-e498-47dd-a36d-bd065e3e2b8e",
"name": "Template name",
"created_at": 1623229458,
"updated_at": 1623229457
}
}
  • id: Banner's id, UUID v4 format.
  • file.type: The banner format it cant be jpeg/png/pdf.
  • file.url: URL where the image is stored.
  • file.cdn_url: The CDN URL where the image is stored (not available for zip files). That URL is designed for high-speed & low-latency performance. A limited bandwidth applies to all plans (see the pricing table).
  • file.filename: Name of the file. If the related template contains a custom naming scheme, the custom name will be available from this property.
  • format.id: The format's name as you defined it in the template.
  • format.width: The format width in pixels.
  • format.height: The format height in pixels.
  • template.id: Template's id, UUID v4 format.
  • template.name: The template name as you defined it in the application.
  • template.created_at: Template creation date, timestamp format.
  • template.updated_at: Template updated date, timestamp format.

NEW_BANNER_BATCH

It can be filtered by template.

Sample response:

{
"id": "c18c3cec-14c2-4539-99d4-92623b6a4aef",
"banners":
[
{
"id": "ec3a9fcd-f209-4077-b5ea-037d4bdfa9f2",
"file":
{
"type": "jpeg",
"url": "url/name.jpeg",
"cdn_url": "cdn_url/name.jpeg",
"filename": "name.jpeg"
},
"format":
{
"id": "facebook",
"width": 1200,
"height": 628
},
"template":
{
"id": "834362df-966b-46fb-a92b-213f3c2ceeac",
"name": "Template name",
"created_at": 1649682431,
"updated_at": 1649682494
}
}
],
"errors":[
{
template_format_name: "(Placeholder Format, will be the real value)",
reason: "Element text_placeholder error: The text 'Placeholder text' cannot fit within the defined space.",
}
]
}
  • id: The generation request id you received when calling the API, UUID v4 format.
  • banners: A list of banners created. Banner properties are the same as the one you can find in NEW_BANNER.
  • errors: A list of errors, if it didn't work during the generation.