Tuğberk AkbulutGet in touch
Back to work

Savaşan İHA API

2021

A reference FastAPI implementation of a national fighter-drone competition's communication protocol.

PythonFastAPI
Source

A FastAPI reference implementation of the communication protocol published for TEKNOFEST 2021’s Fighter UAV (“Savaşan İHA”) competition: the interface competing teams’ autonomous systems used to authenticate, report position and combat state, and get penalized or scored during simulated aerial engagements.

Team Client Savaşan İHA API Oturum Açma (login) session token + status codes position, lock, combat state ack + time-diff, logged repeated every telemetry tick Oturum Kapama (logout)

Each session runs through login, a repeating telemetry loop, and logout. Time differences between client-reported and server-received timestamps are computed and logged on every telemetry tick, error and confirmation codes are validated per the published protocol document, and all submitted team data is persisted for later review or scoring.

Released as an open reference implementation rather than kept as a private competition tool, with the login/session lifecycle, error and confirmation code handling, and data logging already working while the project was still active. It went on to become a starting point other competing teams built against, picking up 23 stars and several forks in the years since.