Skip to content
getgeolens.com
GeoLens Docs

Probe Service Url

POST
/services/probe/
 
curl --request POST \
  --url https://example.com/api/services/probe/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "url": "example", "token": "example" }'

Probe a remote service URL to detect its type and list available layers.

Validates the URL against SSRF, detects whether it is a WFS or ArcGIS service, and returns a unified layer list. All attempts are audit-logged.

Authorizations

Section titled “Authorizations ”

Request Body required

Section titled “Request Body required ”
Media type application/json
ProbeRequest
object
url
required
Url

Service URL to probe. May be a WFS GetCapabilities URL or an ArcGIS service endpoint.

string
>= 1 characters <= 2048 characters
token
Any of:
string
<= 1000 characters
Example generated
{
  "url": "example",
  "token": "example"
}

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

Media type application/json
ProbeResponse
object
service_type
required
Service Type

Detected service type, e.g. ‘WFS 2.0’ or ‘ArcGIS FeatureServer’.

string
url
required
Url

Normalized service URL after probing.

string
layers
required
Layers

Layers exposed by the probed service.

Array<object>
LayerInfo
object
name
required
Name

Internal layer identifier used by the source service.

string
title
Any of:
string
geometry_type
Any of:
string
feature_count
Any of:
integer
layer_type
Layer Type

Layer kind: ‘layer’ (spatial) or ‘table’ (non-spatial attribute table).

string
default: layer
layer_id
Any of:
integer
object_id_field
Any of:
string
selected_layer_id
Any of:
integer
Example 
{
  "layers": [
    {
      "layer_type": "layer"
    }
  ]
}

422

Section titled “422 ”

Validation Error

Media type application/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object
Example generated
{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example",
      "input": "example",
      "ctx": {}
    }
  ]
}