Esportazioni
Estrazioni massive per volumi che sarebbe irragionevole scorrere pagina per pagina. Un'esportazione è asincrona: tu la richiedi, noi la costruiamo e tu recuperi il file quando è pronto.
/v1/api/exportsexports:createElencare le esportazioni
Esportazioni recenti della tua organizzazione, dalla più nuova.
Solo stati. I link di download non sono inclusi qui: generarne uno per riga firmerebbe un URL per ogni esportazione che tu abbia mai fatto, in una chiamata da cui probabilmente volevi solo gli stati. Richiedi la singola esportazione per ottenere un link.
https://api.skautik.com/v1/api/exports
GET /v1/api/exports HTTP/1.1
Host: api.skautik.com
Authorization: Bearer sk_live_…/v1/api/exportsexports:createRichiedere un'esportazione
Metti in coda un'estrazione massiva del catalogo.
Accetta gli stessi filtri dell'endpoint di elenco. Restituisce subito un'esportazione in attesa; iscriviti a export.completed invece di interrogare in continuazione. Tieni presente che un insieme ridotto di campi potrebbe non essere reversibile: reinserire un'esportazione in un'importazione richiede le colonne che un'importazione pretende, fra cui external_id e type, quindi ometti campi per l'analisi e non per una reimportazione.
Campi del corpo
| Nome | Tipo | Descrizione |
|---|---|---|
formatobbligatorio | enum | Formato di uscita. Parquet è nominato nello schema e non è implementato; chiederlo viene rifiutato invece di ricevere un file corrotto. ndjson | csv esempio: ndjson |
filters | object | Le stesse chiavi accettate dall'endpoint di elenco. esempio: {"property_type": "apartment", "price_max": 60000000} |
fields | array | Restringe le colonne. Ometti per la scheda completa. esempio: ["id", "title", "price", "address"] |
Corpo della richiesta
{
"format": "ndjson",
"filters": { "city": "Berlin", "status": "active" },
"fields": ["external_id", "price", "living_area_sqm", "address_city"]
}Risposta
{
"data": {
"id": "exp_74c0ab",
"status": "pending",
"format": "ndjson",
"created_at": "2026-08-12T10:04:00Z"
}
}https://api.skautik.com/v1/api/exports
POST /v1/api/exports HTTP/1.1
Host: api.skautik.com
Authorization: Bearer sk_live_…
Content-Type: application/json
{
"format": "ndjson",
"filters": { "city": "Berlin", "status": "active" },
"fields": ["external_id", "price", "living_area_sqm", "address_city"]
}/v1/api/exports/{export_id}exports:createRecuperare un'esportazione
Stato, e l'URL di download una volta pronta.
Gli URL di download sono firmati e scadono un'ora dopo l'emissione, e vengono generati a ogni richiesta invece di essere memorizzati, quindi richiedine un altro se uno scade. Il file viene conservato per sette giorni; dopodiché l'esportazione compare ancora nel tuo storico senza link, perché l'oggetto è stato rimosso.
Parametri di percorso
| Nome | Tipo | Descrizione |
|---|---|---|
export_idobbligatorio | string | Identificatore dell'esportazione. esempio: exp_74c0ab |
Risposta
{
"data": {
"id": "exp_74c0ab",
"status": "completed",
"format": "ndjson",
"record_count": 1284,
"byte_size": 4821004,
"download_url": "https://exports.skautik.com/exp_74c0ab.ndjson?sig=…",
"expires_at": "2026-08-12T11:12:00Z"
}
}https://api.skautik.com/v1/api/exports/{export_id}
GET /v1/api/exports/exp_74c0ab HTTP/1.1
Host: api.skautik.com
Authorization: Bearer sk_live_…