Vai al contenuto principale
GET
/
search
Ricerca Risorse del Tenant
curl --request GET \
  --url https://api.altostrat.io/search \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "doc_1",
      "name": "Documentazione Progetto Alpha",
      "type": "documento",
      "description": "Documentazione completa per il progetto Alpha che include specifiche API e guide utente.",
      "org_id": "org_MyoAolMD2GACSFi8",
      "workspace_id": "ws_sz47boIRd2XfDRk3G0",
      "metadata": {
        "category": "tecnica",
        "resource_id": "res_doc_001"
      },
      "created_at": "2025-10-24T12:00:00.000000Z",
      "updated_at": "2025-10-27T15:30:00.000000Z",
      "relevance_percentage": 100,
      "scout_score": 123456789
    }
  ],
  "links": {
    "first": "https://api.altostrat.io/search?page=1",
    "last": "https://api.altostrat.io/search?page=5",
    "prev": null,
    "next": "https://api.altostrat.io/search?page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 5,
    "path": "https://api.altostrat.io/search",
    "per_page": 20,
    "to": 20,
    "total": 95
  }
}

Authorizations

​
Authorization
string
header
required

Le API di Altostrat utilizzano token JWT Bearer per l'autenticazione.

Query Parameters

​
q
string
required

La stringa di query di ricerca principale. L'API esegue una ricerca approssimativa (fuzzy) su nomi, descrizioni e metadati delle risorse.

Required string length: 1 - 255
​
workspace_id
string

Un filtro opzionale per limitare i risultati della ricerca a un ID di workspace specifico. Se fornito, org_id viene ignorato. Se omesso, la ricerca viene eseguita nell'ambito dell'organizzazione.

​
org_id
string

Un filtro opzionale per limitare i risultati della ricerca a un ID di organizzazione specifico. Solitamente utilizzato dagli utenti amministratori per cercare al di fuori della loro organizzazione predefinita. Se omesso, la ricerca è limitata all'organizzazione dell'utente autenticato.

​
types
string[]

Un array di tipi di entità per filtrare i risultati. Ad esempio, types[]=device&types[]=policy restituirà solo le entità di questi due tipi.

​
created_from
string<date>

La data di inizio per un filtro sull'intervallo di date di creazione, formattata come AAAA-MM-GG.

​
created_to
string<date>

La data di fine per un filtro sull'intervallo di date di creazione, formattata come AAAA-MM-GG.

​
page
integer
default:1

Il numero di pagina per la paginazione.

Required range: x >= 1
​
per_page
integer
default:20

Il numero di risultati da restituire per pagina.

Required range: 1 <= x <= 100

Response

Un elenco paginato di risultati della ricerca.

​
data
object[]
​
links
object
​
meta
object