uniqc.gateway.api.backends module

Backend listing API — /api/backends.

The gateway UI needs more than the coarse backend cache contains. BackendInfo is still the source of truth for what devices exist, but per-qubit and per-edge calibration details are enriched from the chip-characterization cache when it is available. This keeps the listing endpoint fast and avoids cloud API calls from the web UI request path.

uniqc.gateway.api.backends.get_backend(backend_id)

Get a specific backend by its full id (platform:name).

Parameters:

backend_id (str)

Return type:

dict[str, Any]

uniqc.gateway.api.backends.list_backends()

List all available backends across all platforms.

Return type:

dict[str, Any]

uniqc.gateway.api.backends.list_live_backends()

Flat list of all backends with their cache staleness.

Return type:

list[dict[str, Any]]

uniqc.gateway.api.backends.refresh_backends(platform=None)

Force-refresh cached backend information from platform APIs.

Parameters:

platform (str | None)

Return type:

dict[str, Any]