Skip to content

Latest commit

 

History

History
216 lines (190 loc) · 11.1 KB

README.md

File metadata and controls

216 lines (190 loc) · 11.1 KB

📄 ProgramAPI Output Documentation

⚠️ Some fields may be null, "", or excluded from specific contexts.

🍭 Also, yes, Rick Astley may appear in test videos. You're welcome.

🗣 speakers.json

Example speaker data 
{
  "B4D5E6": {
    "code": "B4D5E6",
    "name": "A Speaker",
    "biography": "Some bio",
    "avatar": "https://pretalx.com/media/avatars/picture.jpg",
    "slug": "a-speaker",
    "submissions": ["A1B2C3"],
    "affiliation": "A Company",
    "homepage": "https://example.com",
    "twitter_url": "https://x.com/B4D5E6",
    "linkedin_url": "https://linkedin.com/in/B4D5E6",
    "mastodon_url": "https://mastodon.social/@B4D5E6",
    "bluesky_url": "https://bsky.app/profile/B4D5E6.bsky.social",
    "gitx_url": "https://github.com/B4D5E6",
    "website_url": "https://ep2099.europython.eu/speaker/a-speaker"
  }
}

Fields

Key Type Notes
code string Unique identifier for the speaker
name string Full name of the speaker
biography string | null Short biography
avatar string URL of speaker's avatar
slug string URL-safe speaker name
submissions array[string] Codes of sessions the speaker is involved in
affiliation string | null Affiliated institution or organization
homepage string | null Personal or professional homepage
twitter_url string | null Normalized Twitter/X profile URL
mastodon_url string | null Normalized Mastodon profile URL
linkedin_url string | null Normalized LinkedIn profile URL
bluesky_url string | null Normalized Bluesky profile URL
gitx_url string | null Normalized GitHub/GitLab profile URL
website_url string Auto-generated speaker profile on the EuroPython site

📚 sessions.json

Example session data 
{
  "A1B2C3": {
    "code": "A1B2C3",
    "title": "Example talk",
    "speakers": ["B4D5E6"],
    "session_type": "Talk",
    "slug": "example-talk",
    "track": "Some Track",
    "abstract": "This is an example talk.",
    "tweet": "This is an example talk.",
    "duration": "60",
    "level": "intermediate",
    "delivery": "in-person",
    "resources": [
      {
        "resource": "https://example.com/slides.pdf",
        "description": "Slides for the session"
      }
    ],
    "room": "South Hall 2A",
    "start": "2099-07-10T14:00:00+02:00",
    "end": "2099-07-10T15:00:00+02:00",
    "website_url": "https://ep2099.europython.eu/session/example-talk",
    "youtube_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "sessions_in_parallel": ["F7G8H9"],
    "sessions_after": ["I0J1K2"],
    "sessions_before": ["L3M4N5"],
    "next_session": "O6P7Q8",
    "prev_session": "R9S0T1"
  }
}

Fields

Key Type Notes
code string Unique session identifier
title string Title of the session
speakers array[string] List of speaker codes
session_type string Type of session (e.g. Talk, Workshop)
slug string URL-friendly session name
track string | null Associated track
abstract string Abstract or session description
tweet string Short summary (tweet-style)
duration string Duration in minutes as string
level string Level of session (e.g. beginner, intermediate)
delivery string Delivery format (in-person or remote)
resources array[object] | null Supplementary materials (URL and description)
room string | null Assigned room (e.g. "Exhibit Hall" auto-mapped for posters)
start datetime | null ISO datetime of start
end datetime | null ISO datetime of end
website_url string URL of session on the EuroPython site
youtube_url string | null YouTube link to session video (🎵 never gonna give you up?)
sessions_in_parallel array[string] | null Session codes running at the same time
sessions_after array[string] | null Sessions immediately after this one
sessions_before array[string] | null Sessions immediately before this one
next_session string | null Next session in the same room
prev_session string | null Previous session in the same room

🗓️ schedule.json

Example schedule day 
{
  "days": {
    "2099-07-08": {
      "rooms": ["Room A", "Room B", "Room C"],
      "events": [
        {
          "event_type": "SESSION",
          "code": "OPQ456",
          "slug": "advanced-python",
          "title": "Advanced Python Techniques",
          "session_type": "Tutorial",
          "speakers": [
            {
              "code": "RST789",
              "name": "John Doe",
              "avatar": "https://pretalx.com/media/avatars/picture.jpg",
              "slug": "john-doe",
              "website_url": "https://ep2099.europython.eu/speaker/john-doe"
            }
          ],
          "track": "CPython Internals",
          "tweet": "",
          "level": "advanced",
          "rooms": ["Room C"],
          "start": "2099-07-08T10:00:00+02:00",
          "duration": 90,
          "website_url": "https://ep2099.europython.eu/session/advanced-python"
        },
        {
          "event_type": "BREAK",
          "title": "Coffee Break",
          "duration": 30,
          "rooms": ["Room A", "Room B"],
          "start": "2099-07-08T11:30:00+02:00"
        }
      ]
    }
  }
}

Fields

Key Type Notes
days dict[date, DaySchedule] Schedule grouped by day
rooms list[string] All rooms active on that day
events list[Session or Break] Mixed list of sessions and breaks

Session (EventType = "SESSION")

Field Type Notes
event_type "SESSION" Constant
code string Session code
slug string URL-friendly name
title string Title of the session
session_type string Talk, Workshop, etc.
speakers array[Speaker] Mini speaker profiles
track string | null Optional topic track
tweet string Short description
level string Beginner, Intermediate, etc.
rooms array[string] One or more rooms
start datetime ISO 8601
duration int Computed from total_duration / slot_count
website_url string Link to session page

Break (EventType = "BREAK")

Field Type Notes
event_type "BREAK" Constant
title string Name of the break
duration int Minutes
rooms array[string] Rooms where the break applies
start datetime Start time

🛠 Notes & Logic

  • room normalization maps "Main Hall" sessions to "Exhibit Hall" — Poster sessions rejoice!
  • All "Registration & Welcome" events automatically include all active rooms.
  • Various social_*_url fields handle malformed inputs like @name, full URLs, or just username.