SHshapemaker
shelter-definitions

Get Shelter Definitions

This endpoint lists the organization's library of standardized shelter types. Sites place a definition from this library and adjust only its position.

get/v1/shelter-definitions

Request

  • Base URL
    https://api.shapemaker.io (the document declares no server; this is the origin it was published from)
  • Auth
    OAuth 2
    Password
    Token URL: /v1/auth

Response

Successful Response

idinteger required
namestring required
createdBystring required
widthMnumber required
depthMnumber required
heightMnumber required
roofHeightMnumber required
doorWall'FRONT' | 'BACK' | 'LEFT' | 'RIGHT'

Which shelter wall the door, or the feeder tray, sits in.

Named from the shelter's own shape rather than the site: the duopitch ridge runs along the width axis, so FRONT and BACK are the gable ends and LEFT and RIGHT are the long eave walls. In shelter-local axes (x along the width, y along the depth), the wall each name refers to is:

  • FRONT: the +x gable end
  • BACK: the -x gable end
  • LEFT: the -y long wall
  • RIGHT: the +y long wall

shelter_wall_axes in app/modules/geometry_definitions/shelter/position.py is the single source of these directions; keep the two in step.

Alembic does not detect changes in enums, so the enum constraint has to be manually migrated when changing this enum

doorOffsetMnumber nullable
doorWidthMnumber nullable
trayWall'FRONT' | 'BACK' | 'LEFT' | 'RIGHT'

Which shelter wall the door, or the feeder tray, sits in.

Named from the shelter's own shape rather than the site: the duopitch ridge runs along the width axis, so FRONT and BACK are the gable ends and LEFT and RIGHT are the long eave walls. In shelter-local axes (x along the width, y along the depth), the wall each name refers to is:

  • FRONT: the +x gable end
  • BACK: the -x gable end
  • LEFT: the -y long wall
  • RIGHT: the +y long wall

shelter_wall_axes in app/modules/geometry_definitions/shelter/position.py is the single source of these directions; keep the two in step.

Alembic does not detect changes in enums, so the enum constraint has to be manually migrated when changing this enum

trayOffsetMnumber nullable
partitionOffsetMnumber nullable
partitionDoorWidthMnumber nullable
partitionDoorOffsetMnumber nullable
partitionHasDoorboolean

Changes

No recorded changes to this operation across all 1 revision of this API.