Developer Tools

Overview

Developer Tools is the integration hub of Ananas GDS. It provides four distinct capability areas: token-based API access for partners, embeddable HTML/JS widgets for displaying fact sheets on external sites, outbound webhooks for real-time event delivery, connections to external GDS/OTA/PMS platforms, and a bulk data export engine. All capabilities are scoped to the authenticated owner; sub-users require the developer_tools permission flag.

API Keys

API keys (model ApiKey in the settings app) give external systems — tour operators, channel managers, and partner integrations — token-based read access to your data. Each key is tied to a whitelisted domain and carries per-resource permission flags.

The token is passed in the URL path of v1 API requests:

GET https://app.ananas-gds.com/api/v1/facts/{token}/
GET https://app.ananas-gds.com/api/v1/photos/{token}/
GET https://app.ananas-gds.com/api/v1/stop-sale/{token}/

Domain Whitelist

Each API key requires a Whitelist entry. The whitelist associates a human-readable name with a domain pattern, allowing the backend to reject requests from unauthorised origins when the token is used in browser-side code.

API Key Endpoints

Embeddable Widgets

Widgets let you embed a styled fact sheet directly on any external website. Each widget is bound to a specific property and API key. You configure the visual appearance — fonts, colours, sections, layout — in the widget editor, then copy the generated embed code.

Widget Sections

A widget is composed of one or more ordered sections. Each section has a type and optional style overrides:

Embed Code

Three embed options are available from the widget editor:

<iframe src="https://app.ananas-gds.com/widget/{key}/"
        width="100%" height="600" frameborder="0"></iframe>

<div id="ananas-widget"></div>
<script src="https://app.ananas-gds.com/widget.js"
        data-key="{key}"></script>

Widget Endpoints

External Connections

The Integrations section lets you connect Ananas GDS to external platforms. Supported system types cover GDS (Amadeus, Sabre, Travelport), OTA (Booking.com, Expedia, Airbnb, TripAdvisor), PMS (Oracle Opera Cloud, Mews, Cloudbeds, Apaleo, SiteMinder), and custom endpoints.

Each sync attempt is recorded in a ConnectionSyncLog with status, records processed, records failed, and a message for debugging.

Integration Endpoints

Outbound Webhooks

Register HTTPS endpoints to receive real-time notifications when data changes in Ananas GDS. Each webhook endpoint subscribes to one or more event types. Payloads are HMAC-signed using the endpoint's secret for verification.

Supported Events

Delivery attempts are logged in WebhookDelivery records. Failed deliveries are retried with exponential backoff. Each delivery record stores the response code, response body, attempt count, and next retry timestamp.

Webhook Endpoints

Data Exports

The Export Center generates bulk data files in multiple formats. An export request is created asynchronously — a Celery task processes the request and stores the resulting file.

Usage Statistics

API usage is tracked in the APIStats model (reports app) per token per endpoint per day. The statistics dashboard provides per-token breakdowns with ApexCharts visualisations: total hits, successful hits, errors, bytes transferred, and active tokens over time. A pre-aggregated APIStatsSummary model powers fast dashboard reads without querying the raw stats table.

Sub-User Access

Sub-users require developer_tools = True in UserPermission to access any Developer Tools endpoint. Without this flag all dev tools API calls return HTTP 403.