Skip to content

API Basics

The FieldTwin API allows you to quickly build integrations on your own where you can connect FieldTwin with you own software applications and/or backend systems. This allows you integrate with e.g. Enterprise Document Systems, Simulations or calculations software. But first lets cover some of the basic principles of what the FieldTwin platform offers.

Data Exchange

The FieldTwin Platform allows you to easily import various data sources to help build out your Energy field layout. Examples of this would typically be:

  • Bathymetry, reservoir, 2D and 3D surfaces from files
  • Connections from file, Web Feature Service (WFS) or ArcGIS
  • Layers from file, Web Map Service (WMS) or ArcGIS
  • Wells (and trajectories) from file
  • Images

You can also Export directly from FieldTwin. Examples of this would be:

  • Project connections to XYZ, Shapefile or GeoJSON files
  • Project wells to XYZ, Shapefile or GeoJSON files
  • Project assets to Shapefile, GeoJSON or Excel files
  • Project shapes to Shapefile, GeoJSON or GLTF files
  • Bathymetry contours as Shapefile
  • Whole field as Shapefile, GeoJSON or image files

See the illustration below for an overview:

Overview

You can also use the built in Rules Engine. This allows you to define your own logical rules to import layers, connections, assets, wells and their associated metadata direct from ArcGIS Servers or Excel files.

See the illustration below for an overview:

Overview

See the following example video explaining this powerful functionality:

You can also go straigth to the tutorial section

Almost anything in FieldTwin then can be accessed through the FieldTwin API

Data Objects

FieldTwin supports a range of different data objects and data types you can utilize when you are building your integrations.

Overview

Examples are:

  • Metadata
  • Asset and project costs (per item),connection costs (per meter)
  • Custom connection types,
  • Connection segment types
  • Layer types,
  • Well types, well bore types, well bore segment types,
  • Shape types
  • Virtual assets

All definitions are accessible and changeable through the FieldTwin API. See FieldTwin Admin Docs

Metadata

Vital for many integrations, and supports your workflows, processes, standards, and compliance needs. Capture data to send to other systems as well as import data from other systems. It has unambiguous links using FieldTwin’s ID or your own Vendor ID.

Overview

Read more here FieldTwin Admin Docs

API

The FieldTwin API is a Web-based REST API, which is an industry standard technology. You can collaborate with others, and others can collaborate with you. The API is secured by a private token. It provides read/write access to (almost) all your data in FieldTwin and also offers remote management capabilities. You have access to the API with a FieldTwin Partner or Advanced License.

API - Data Access

What does it do?

  • Create, read, update and delete…
  • Project assets, wells and bores, connections, shapes, layers
  • Metadata
  • Attach custom values and pipeline visualization data
  • Upload/download linked files or documents
  • Attach custom values to account, project, subproject
  • Perform height/depth sampling
  • Generate connection profiles
  • Detect connection crossings

API - Remote Configuration

The API provides CRUD operations (Create, read, update and delete) on:

  • Metadata definitions and groups
  • Metadata associations
  • Connection definitions
  • Connection design and segment types
  • Layer types
  • Shape types
  • Well types
  • Well bore and segment types
  • Virtual assets

API - Project Information

The API allows you to obtain or update the following project information:

  • List projects
  • Update project or subproject settings
  • Create read-only sharing link
  • List tags in use

API - Remote Management

  • List users, register users
  • Assign user permissions
  • Activity reporting
  • Audit trail / changes reporting
  • Install or remove an integration

API - What does it not do?

  • Clone projects
  • Shapes are read-only
  • Connection segments are read-only
  • Well bore segments are read-only

Do contact us if you have a use-case that the API does not cover. We are typically very responsive and FieldTwin is SaaS, so we can quickly roll out enhancements.

API - Security

Use of the API requires an access token

Option 1: API Token

  • Created in FieldTwin Admin - Account Settings
  • Full access to everything in one account
  • or
  • Assign a user role (new in FieldTwin 8.0) = the project data allowed by that role plus read-only access to the account configuration
  • Never expires
  • Must be kept secret

Use for:

  • Non-interactive or background integrations (without a user)
  • Handling situations where the user does not normally have permission
  • Administration and management tasks

Option 2: JSON Web Token (JWT)

  • Provided by FieldTwin once logged in
  • Represents the current user and the current project
  • Restricts access to the user’s normal permissions
  • Expires after 1 hour (FieldTwin sends a replacement)

Use for:

  • Interactive integrations (working as a logged in user)
  • Integrations hosted inside FieldTwin
  • Working with a project or subproject
  • Use in preference to an API Token