🧩 JFM / Flowplayer Integration

Overview

The JFM integration connects our internal broadcast scheduler to the Flowplayer JFM API, enabling automatic creation and updates of livestreams for Danish sports sites.

🏷️ Supported Site IDs

Site ID	Description
`COM_DANS1`	Dansk Sports Site 1
`COM_META`	Metalliagen
`DBBF`	Danish Basketball Federation
`FBDK`	Danish Football Federation
`DIU`	Danish Ice Hockey Union
`COM_VBDK`	Danish Volleyball Federation
`COM_DANS3`	Dansk Sports Site 3

⚙️ Prerequisites

Each scheduled broadcast must include the following fields before it can sync with Flowplayer:

Field	Requirement	Example
`extId`	External broadcast identifier	`113198`
`startTime`	Must be in the future (UTC)	`2026-02-01T11:00:00Z`
`endTime`	Must be after startTime	`2026-02-01T13:00:00Z`

⚠️ If any of these fields are missing or invalid, the broadcast will not be created or updated in Flowplayer.

🏷️ Category ID (Required)

A valid categoryId is mandatory for the JFM integration to function.

The categoryId must exist in Flowplayer JFM
It is used to classify the livestream by sport
Broadcasts without a valid categoryId will not sync
Invalid or missing categoryIds cause the broadcast to be rejected or removed

The categoryId is configured per integration and applies to all synced broadcasts.

Supported Category IDs

Sport	Category ID
American Football	8fcddea5-f29a-49f3-9a8c-e392d99f84cb
Basketball	5d236945-960a-4fc5-8340-bd548ed0c1b5
Floorball	f5f84edf-2807-4fd3-bee6-dafbd001e34a
Football (Soccer)	a46e9e68-d7f8-4765-9986-0952d2d4af2e
Futsal	1cecc794-107f-46d7-89f8-c8859977e333
Handball	bb75bc52-80fd-4301-b0d8-69a2cc43cce5
Equestrian	ac889f75-a8bf-4b79-88e0-397a6be3dd5a
Ice Hockey	2b2bcc47-eab8-4e1c-a30e-4c98d3e81dc5
Martial Arts	dcf93d02-0a58-4671-8422-149e13ae65ea
Other Sports	a4265a4f-fa15-4e58-b51b-61b2167018e4
Padel & Tennis	f2b8c811-003f-44df-a837-771b11dde586
Speedway	ed4ae66c-c29b-4c48-9ed9-a5df85b537b0
Sport Live 24	1e1c09e6-c74e-4c91-8a4a-4a90dd85aa85
Swimming	64b44f40-27da-4035-919f-4839fb7f3237
Winter Sports	94bfdfca-45f5-4d64-8f33-3042ac007143
Volleyball	e9157446-ae46-427f-ac47-86b4ac64bfb4

🏷️ Tags (Optional)

Tags can be configured for the JFM integration and are applied to broadcasts created in Flowplayer.

Tags are optional
Tags are a comma-separated list (e.g. women,playoffs,final)
Tags are set on all broadcasts created after the tags are added or updated
Updating tags does not retroactively change existing broadcasts

🚀 Enabling the Integration

Go to Configurations → Rules in Backoffice
Enable JFM API Integration
Select a valid Category ID (see section above)
Click Save

⚠️ IMPORTANT

The integration must be enabled on stream2
A valid categoryId is required or synchronization will fail

✅ Verification

Once active, broadcasts for the supported siteIds with valid data will sync automatically.
Check Broadcast -> Status Logs to review integration errors.

⚠️ Error Codes

Code	Meaning	Action
400	Stream Scheduler received a broadcast event missing required fields.	The broadcast was removed from Flowplayer.
429	The integration hit Flowplayer’s rate limit.	The job will retry automatically (see below).

🔁 Retry Logic

If a scheduled action fails, the Stream Scheduler will automatically retry:

Every 36 hours if there are more than 3 days left until broadcast start.
Every hour if there are less than 3 days left until broadcast start.

Retries continue until the broadcast is successfully synced or expired.

🧠 Notes

API rate limit: 3 requests/second (handled internally by the scheduler).
The integration respects per-site and per-competition configuration and category mappings.