2026-10-23 12.00 UTC - There are currently no active events. All systems operational.

Apply accepted connection comparison values to the duct

Prev Next
Post
/manhole-connection-duct-diff/

Operation is used to write the values a user accepted in a manhole inspection connection comparison onto the KeyAqua duct the connection was compared against.

kote is written directly, to the end of the duct that meets this manhole - the begin end for an outlet, the far end for an inlet.

dim is not a column on the duct: diameter lives on a shared duct type row, so an accepted dimension points the duct at the type carrying it and never edits the type itself, which other ducts use. When the catalogue holds no type for the resulting combination the request is refused and nothing is written; duct types are added through Django admin.

tvaersnit is the duct's own profile column, written directly.

materiale_kode names a duct type like the dimension does, so it points the duct at the catalogue row carrying that material. The DANVA code is mapped to a KeyAqua duct material first; a code with no counterpart - lining, glazed clay, brick, other - is refused rather than approximated.

Security
API Key: Token
Header parameter nameAuthorization

Token issued for API consumer.

Body parameters
object
accepted_fields
Array of string Required

The connection fields the user accepted.

string
Valid values[ "kote", "dim", "materiale_kode", "tvaersnit" ]
snsewerduct_id
integer Required

Id of the duct to write to. Must be connected to the manhole the inspection resolves to.

snsewernode_id
integer

Optional manual pick - if provided, this snsewernode is used instead of the resolved one. Pass the node the comparison returned, or the level may be written to the wrong end of the duct.

tilslutning_guid
string Required

GUID of the BRTilslutning connection whose values are applied

tolerance
number

Maximum auto-match distance in meters when the manhole is resolved by proximity. Defaults to 0.2 (20 cm). Pass the value the comparison used.

Responses
200

The values were applied

object
snsewerduct_id
integer

Id of the duct that was written to.

tilslutning_guid
string

GUID of the connection whose values were applied.

updated_fields
Array of string

The duct's own fields that changed. Type appears when the duct was pointed at another duct type.

string
400

There was an error in request. Field validation failed, no manhole could be resolved for the inspection, or no duct type carries the accepted combination - in which case the error names the field and the value.

object

Fields which failed validation

property*
Array additionalProperties

List of validation errors for this fieldname

401

Authentication credentials are missing or invalid

{
  "details": "Authentication credentials were not provided"
}
object

Standard error response payload

details
string

Detailed description of error

403

The user may not modify this duct or use this inspection.

404

Object was not found

{
  "details": "Not found."
}
object

Standard error response payload

details
string

Detailed description of error