Skip to content

Documentation: Device Manager

David edited this page May 21, 2023 · 1 revision

FastAPI

Version: 0.1.0

/api/v1/device/health/readiness

GET

Summary:

Readiness

Description:

Readiness health endpoint.

Inspects sqlalchemy engine and check if workflow table exists.

Returns

Status docstring

Raises

HTTPException 500: Workflow table not found

Responses
Code Description
200 Successful Response

/api/v1/device/

GET

Summary:

Get Devices

Description:

Get all devices endpoint.

Returns

List of device pydantic output models
Responses
Code Description
200 Successful Response

POST

Summary:

Create Device

Description:

Create new device endpoint.

Parameters

payload Device pydantic base model

Returns

Device pydantic output model

Raises

HTTPException 404: Creation unsuccessful

Responses
Code Description
201 Successful Response
422 Validation Error

/api/v1/device/{device_id}

GET

Summary:

Get Device

Description:

Get device endpoint.

Parameters

device_id Id of requested device

Returns

Device pydantic output model

Raises

HTTPException 404: Not found

Parameters
Name Located in Description Required Schema
device_id path Yes integer
Responses
Code Description
200 Successful Response
422 Validation Error

PUT

Summary:

Update Device

Description:

Update device endpoint.

Parameters

device_id Id of device to be updated payload New device pydantic base model, contains new data

Returns

Updated device pydantic output model

Raises

HTTPException 404: Not found

Parameters
Name Located in Description Required Schema
device_id path Yes integer
Responses
Code Description
200 Successful Response
422 Validation Error

DELETE

Summary:

Delete Device

Description:

Delete device endpoint.

Parameters

id Id of device to be deleted

Raises

HTTPException 404: Not found

Parameters
Name Located in Description Required Schema
device_id path Yes integer
Responses
Code Description
204 Successful Response
422 Validation Error