AviaFrame Technical Guide

1. Widget Embed

<div
  id="aviaframe-widget"
  data-api-url="https://api.partner.com/webhook/drct/search"
  data-checkout-url="https://app.partner.com/booking"
  data-language="en"
  data-primary-color="#1A4DFF"
  data-title="Flight Search"
  data-logo-url="https://partner.com/logo.svg"
></div>
<script src="https://cdn.aviaframe.com/widget/aviaframe-widget.js"></script>

2. Supported Runtime Attributes

data-api-url (required)
data-checkout-url
data-language (en, ru)
data-primary-color (hex)
data-title
data-logo-url

3. Events

window.addEventListener('aviaframe:results', (e) => {});
window.addEventListener('aviaframe:offerSelected', (e) => {});
window.addEventListener('aviaframe:continueToBooking', (e) => {});

4. API Contract (minimum)

POST body: origin, destination, depart_date, adults, etc.

Response body: {"offers": [...]} with offer_id, schedule and price.total/currency.

5. Troubleshooting

Check network: script and API both return 200
Check CORS allowlist for host domain
Check browser console for runtime errors
Verify container id is exactly aviaframe-widget