Developer documentation

Your first API request, authentication, data contracts, map publishing and deployment.

First request

Reading and monitoring data

Event notifications and map publishing

Fundamentals

OverviewUnderstand the application architecture and the current integration API contract.Your first API requestCreate an access key, read project data, write an authorised point and track changes.API versioning and changesDistinguish the API contract from the application version and follow documentation changes.API contract rulesRead the rules for base URLs, headers, authentication, coordinates, pagination and safe retries.API field glossaryUnderstand the types and meanings of identity, pagination, editing and error fields.Authentication and scopeSet the integration key scope and distinguish the external API from application sessions.v1 integration APIRead project data with an access key, track changes and write with version control.Access keysCreate and revoke integration keys with read, write and project scopes.Webhook notificationsReceive project events, verify raw-body signatures and handle repeat deliveries.OGC data and map servicesRead project features through OGC API Features and use WMS map layers.Error codes and client decisionsInterpret HTTP status, machine codes and field details together, and choose safe retry behaviour.Reading error responsesUse the current error-code glossary for error envelopes and client decisions.Concurrency and safe retriesManage record versions, operation identifiers and batch changes correctly.

Data

Data modelLearn the main entities, project boundaries and identifier meanings.Editing APICreate and update features, equipment and connections with a batch edit request.Feature types and fieldsUse catalogue map and equipment types with their validation rules.

Import and export

Import APIImport geometries and unit tables through upload, preview and confirmation steps.Export APIExport project geometries by format, feature type and map extent.Project bundleUnderstand the bundle format, its contents and the rules for restoring into an empty project.Outputs APIRetrieve field reports and combined output packages over HTTP.

Installation

Installation and operationsPrepare application dependencies, environment settings and administration commands.Licensing and clock behaviourUnderstand on-premises licence files, licence states and their effect on API write permissions.

Reference

API referenceEndpoint contracts grouped into the versioned v1 API, OGC map services and application APIs.

API reference

Versioned API v1 referenceVersioned API v1 endpoint authentication, parameters, request and response contracts.OGC map services referenceOGC map services endpoint authentication, parameters, request and response contracts.Import sources referenceImport sources endpoint authentication, parameters, request and response contracts.Connection tracing referenceConnection tracing endpoint authentication, parameters, request and response contracts.Building candidates referenceBuilding candidates endpoint authentication, parameters, request and response contracts.Unit candidates referenceUnit candidates endpoint authentication, parameters, request and response contracts.Unit import referenceUnit import endpoint authentication, parameters, request and response contracts.Unit decisions referenceUnit decisions endpoint authentication, parameters, request and response contracts.Unit and endpoint records referenceUnit and endpoint records endpoint authentication, parameters, request and response contracts.Equipment referenceEquipment endpoint authentication, parameters, request and response contracts.Editing referenceEditing endpoint authentication, parameters, request and response contracts.Nodes referenceNodes endpoint authentication, parameters, request and response contracts.Export referenceExport endpoint authentication, parameters, request and response contracts.Electric (Coming soon) referenceElectric (Coming soon) endpoint authentication, parameters, request and response contracts.Access keys referenceAccess keys endpoint authentication, parameters, request and response contracts.Labels referenceLabels endpoint authentication, parameters, request and response contracts.History referenceHistory endpoint authentication, parameters, request and response contracts.Route referenceRoute endpoint authentication, parameters, request and response contracts.Cables referenceCables endpoint authentication, parameters, request and response contracts.Outage impact referenceOutage impact endpoint authentication, parameters, request and response contracts.Users referenceUsers endpoint authentication, parameters, request and response contracts.Organisations referenceOrganisations endpoint authentication, parameters, request and response contracts.Fiber strand assignment referenceFiber strand assignment endpoint authentication, parameters, request and response contracts.Bill of quantities (BoQ) referenceBill of quantities (BoQ) endpoint authentication, parameters, request and response contracts.Features referenceFeatures endpoint authentication, parameters, request and response contracts.OTDR location referenceOTDR location endpoint authentication, parameters, request and response contracts.Optical calculations referenceOptical calculations endpoint authentication, parameters, request and response contracts.Optical measurements referenceOptical measurements endpoint authentication, parameters, request and response contracts.Session referenceSession endpoint authentication, parameters, request and response contracts.Project bundle referenceProject bundle endpoint authentication, parameters, request and response contracts.Project policy referenceProject policy endpoint authentication, parameters, request and response contracts.Project summary referenceProject summary endpoint authentication, parameters, request and response contracts.Projects referenceProjects endpoint authentication, parameters, request and response contracts.Reference layers referenceReference layers endpoint authentication, parameters, request and response contracts.Field attachments referenceField attachments endpoint authentication, parameters, request and response contracts.Health referenceHealth endpoint authentication, parameters, request and response contracts.Technical circuits referenceTechnical circuits endpoint authentication, parameters, request and response contracts.Topology checks referenceTopology checks endpoint authentication, parameters, request and response contracts.Webhook management referenceWebhook management endpoint authentication, parameters, request and response contracts.Outputs referenceOutputs endpoint authentication, parameters, request and response contracts.Metadata referenceMetadata endpoint authentication, parameters, request and response contracts.Import referenceImport endpoint authentication, parameters, request and response contracts.