Listar ítems de un preview de importación con su geometría

curl --request GET \
  --url https://api.ugps.io/api/geofences/imports/previews/{previewId}/items \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.ugps.io/api/geofences/imports/previews/{previewId}/items"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.ugps.io/api/geofences/imports/previews/{previewId}/items', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.ugps.io/api/geofences/imports/previews/{previewId}/items",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.ugps.io/api/geofences/imports/previews/{previewId}/items"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.ugps.io/api/geofences/imports/previews/{previewId}/items")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "data": {
    "items": [
      {
        "id": "507f1f77bcf86cd799439099",
        "name": "<string>",
        "originalName": "<string>",
        "status": "pending",
        "rejectedReason": "<string>",
        "partIndex": 123,
        "partsTotal": 123,
        "originalVertices": 123,
        "simplifiedVertices": 123,
        "geometry": {
          "type": "polygon",
          "points": [
            {
              "lat": 123,
              "lng": 123
            }
          ]
        }
      }
    ],
    "pagination": {
      "page": 123,
      "limit": 123,
      "total": 123,
      "pages": 123
    }
  }
}

{
  "error": "El email es requerido"
}

{
  "error": "Token inválido o expirado"
}

{
  "error": "Recurso no encontrado"
}

{
  "message": "Error interno del servidor"
}

Tracking - Geocercas

Listar ítems de un preview de importación con su geometría

Lista los ítems generados por un preview de importación, incluyendo la geometría de cada geocerca parseada, para previsualizarlas en el mapa antes de confirmar.

Permisos requeridos: access_locations

Comportamiento:

Solo retorna ítems si la sesión de preview pertenece al cliente y usuario autenticados
La sesión de preview expira por TTL (~1 hora) si no se confirma

Notas:

A diferencia de GET /api/geofences/imports/{importId}/items, este listado incluye geometry y funciona antes de confirmar

GET

api

geofences

imports

previews

{previewId}

items

Listar ítems de un preview de importación con su geometría

curl --request GET \
  --url https://api.ugps.io/api/geofences/imports/previews/{previewId}/items \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.ugps.io/api/geofences/imports/previews/{previewId}/items"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.ugps.io/api/geofences/imports/previews/{previewId}/items', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.ugps.io/api/geofences/imports/previews/{previewId}/items",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.ugps.io/api/geofences/imports/previews/{previewId}/items"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.ugps.io/api/geofences/imports/previews/{previewId}/items")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "data": {
    "items": [
      {
        "id": "507f1f77bcf86cd799439099",
        "name": "<string>",
        "originalName": "<string>",
        "status": "pending",
        "rejectedReason": "<string>",
        "partIndex": 123,
        "partsTotal": 123,
        "originalVertices": 123,
        "simplifiedVertices": 123,
        "geometry": {
          "type": "polygon",
          "points": [
            {
              "lat": 123,
              "lng": 123
            }
          ]
        }
      }
    ],
    "pagination": {
      "page": 123,
      "limit": 123,
      "total": 123,
      "pages": 123
    }
  }
}

{
  "error": "El email es requerido"
}

{
  "error": "Token inválido o expirado"
}

{
  "error": "Recurso no encontrado"
}

{
  "message": "Error interno del servidor"
}

Authorizations

Authorization

string

header

required

Token de sesión Better Auth o API token (atk_...) en el header Authorization: Bearer <token>. Los JWT legacy ya no son válidos.

Path Parameters

previewId

string

required

ID de la sesión de preview (24 caracteres hex)

Pattern: ^[a-fA-F0-9]{24}$

Query Parameters

page

integer

default:1

Página a retornar

Required range: x >= 1

limit

integer

default:200

Ítems por página (máximo 500)

Required range: 1 <= x <= 500

status

enum<string>

Filtra por estado del ítem ('all' retorna todos)

Available options:

all,

pending,

rejected,

duplicate

Response

Ítems del preview

status

string

Example:

"success"

data

object

Show child attributes