For the complete documentation index, see llms.txt. This page is also available as Markdown.

API query

Connect external REST APIs as data sources for your Breakdance loops. Fetch, sync, and display data from any API endpoint — all manageable from the WordPress admin.

API Source Manager

Create and manage API data sources from Woohoo Filters > API Sources in your WordPress admin. Each source defines an API endpoint, authentication, and sync schedule.

Supported features:

  • Authentication methods: Bearer token (static or dynamic), Basic Auth, Custom Headers, and OAuth2 with automatic token refresh and 401 retry

  • Response formats: JSON (default), CSV, and XML with auto-detection

  • Custom headers and query parameters: Add any HTTP headers or URL parameters your API requires

  • Encryption: Sensitive credentials (API keys, tokens, passwords) are encrypted at rest using AES-256-CBC

Data Sync

  • Manual sync: Trigger from the admin UI at any time

  • Sync cancellation: Cancel a running sync via the admin UI or REST endpoint

  • Error reporting: Detailed error messages for HTTP failures, rate limiting, and malformed responses

  • Rate limiter: Built-in request throttling to respect API rate limits

Test Connection

Before committing to a full sync, use Test Connection to preview the API response. Shows the first few records, response headers, and confirms your authentication works.

Breakdance Integration

API source data is stored as a custom post type (woohoo_api_item) and is fully queryable in Breakdance. Use Dynamic Data fields to display API-sourced content in any Breakdance element.

Last updated