The "welltopdata" web service provides information about an individual well top.

A typical URL is http://myserver.mycompany.com:8080/INTGeoServer/api/ds/{datasourcetype}/v1/sources/{datasource}/tops/{topuniqueid} with the GET method.

where

datasourcetype: type of a datasource, i.e. mongo, s3, etc.

datasource: a unique id of a datasource

topuniqueid: a unique if of a well top

Here is an example response. This response has been formatted to improve readability.

{

"from": {

"actor": "akka://DefaultActorSystemControllerActorSystem:FindTopByUniqueIdJsonActor:FindFirstAndLastEntryLogsByEntityListResponse for FindFirstAndLastEntryLogsByEntityRequest:FindFirstAndLastEntryLogsByEntityRequest{klass=AbstractEntryLogFinder, sourceType=mongo, sourceName=ecd55dc9-e37c-49c8-a2f7-4313a8fe6a16, entityUniqueId=79264056-db93-492e-91a9-5b7e176b16e4, entity=top}"

},

"data": {

"id": "79264056-db93-492e-91a9-5b7e176b16e4",

"content": {

"topSetUUID": "ccd31862-e74f-4e47-b3b1-0cd18bd06f62",

"wellboreUID": "90afe2a1-abc9-4fd3-bc33-ec7ad0b80ba8",

"name": "mynewtop",

"index": 1996.15,

"interpreter": "MichaelM",

"label": "IVAAPMiddleTier://cec5dc52-a6a9-4ef4-be6d-f62f560f2c00"

},

"links": [

{

"rel": "self",

"relEntity": "v1/schema/int/top",

"href": "/ivaap/api/ds/mongo/v1/sources/ecd55dc9-e37c-49c8-a2f7-4313a8fe6a16/tops/79264056-db93-492e-91a9-5b7e176b16e4",

"children": false,

"hasProjectEntityChildren": false,

"isProjectEntity": false

}

]

}

}

The id entry is a unique id of a well top.

In content section

• topSetUUID is the unique id of a parent top set

• wellboreUID is the unique id of a parent well bore (or well if well bores are not supported)

• name is the name of a well top

• index is the depth of a well top

• interpreter is an interpreter of a well top

• label is the lable of a well top

The links section provides a HATEOAS link to this service.

If the specified topuniqueid doesn't match a valid well top, no JSON response will be provided. The HTTP response will only show a "InvalidUniqueId" (error 404) in its headers.