Preskoči na sadržaj
Sursa Developers

GET/v1/folders

Dohvaćanje stabala mapa svih zbirki

folder_trees

Vraća u jednom odgovoru stabla mapa svih zbirki u kojima korisnik može vidjeti barem jedan objekt, s istim pravilima vidljivosti kao GET /v1/collections/{name}/folders i redoslijedom kao GET /v1/collections. Zbirka bez vidljivih objekata izostavlja se. Osim cards, svaka mapa ima zbrojeve za podstablo cards_total, sensitive_total i top_category. Uz updated_since ili metadata[<key>]= folders svake zbirke sadrže odgovarajuće mape kao ravan popis (children je prazan, a parent_id daje mjesto u stablu). Uz updated_since mape su poredane po updated_at uzlazno, zatim po id; bez njega po sort_key. Zbirke bez odgovarajućih mapa izostavljaju se.

Autentifikacija

Pošaljite API ključ u zaglavlju Authorization: Authorization: Bearer <ključ>.

Parametri upita

  • limitinteger

    Veličina stranice. Bez limit i cursor vraća se cijeli popis; s njim – najviše limit stavki, a sljedeća stranica navodi se u zaglavljima Link (rel="next") i X-Next-Cursor.

    ≥ 1, ≤ 200

  • cursorstring

    Kursor sljedeće stranice iz X-Next-Cursor ili next_cursor prethodnog odgovora s istim filtrima; nosi veličinu stranice. Zajedno s offset: 422 validation.failed; kursor drugog popisa, drugih filtara ili neispravan kursor: 400 api.cursor_invalid.

    length ≤ 512

  • updated_sincestring (date-time)

    Samo objekti s updated_at u tom trenutku ili nakon njega (RFC 3339 s pomakom), za sinkronizaciju. Uz njega je popis poredan po updated_at uzlazno, zatim po id, a kursor nastavlja tim redoslijedom. Izbrisani objekti nisu na popisu: brisanja stižu kao događaji.

    length ≤ 512

  • metadatamap of string

    Filtar po metadata: metadata[<key>]=<value> traži točno podudaranje. Do 3 uvjeta, i svi moraju biti ispunjeni (?metadata[team]=support&metadata[crm_id]=A-1042). Više od 3 uvjeta ili nevaljan ključ vraća 400 api.metadata_invalid.

Odgovori

200Uspješan odgovor

Zaglavlja odgovora

  • Link

    Adresa sljedeće stranice, <…>; rel="next". Ako zaglavlja nema, ovo je posljednja stranica.

  • X-Next-Cursor

    Kursor sljedeće stranice za parametar cursor. Ako zaglavlja nema, ovo je posljednja stranica.

  • RateLimit-Policy

    Ograničenja na snazi, u formatu IETF nacrta draft-ietf-httpapi-ratelimit-headers: stavke odvojene zarezima "<name>";q=<quota>;w=<window in seconds>. key je učestalost zahtjeva API ključa (kvota je nalet, prozor je vrijeme do njegova potpunog obnavljanja; za sesiju je to user, bez vjerodajnica ip); minute, day i month su kvote organizacije za kalendarsku minutu, dan i mjesec po UTC-u.

  • RateLimit

    Što je preostalo od svakog ograničenja u RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    Ograničenje najstrože stavke u RateLimit-Policy (one s najmanje preostalih zahtjeva).

  • X-RateLimit-Remaining

    Preostali zahtjevi u okviru najstrožeg ograničenja.

  • X-RateLimit-Reset

    Broj sekundi do obnove najstrožeg ograničenja.

application/json

Objekt: FolderTreeList

array of FolderTree
  • collection_idintegerobavezno
  • collection_namestringobavezno
  • collection_titlestringobavezno

    Naziv zbirke za prikaz.

  • permissionsarray of stringobavezno

    Stvarna dopuštenja korisnika na zbirci.

  • unfiledintegerobavezno

    Kartice zbirke dostupne korisniku koje nisu ni u jednoj mapi. Arhivirane kartice ne broje se, kao u zadanom popisu kartica.

  • foldersarray of FolderNodeobavezno
401Vjerodajnice nisu poslane (ni kolačić sesije ni API ključ) ili ključ nije pronađen.

Zaglavlja odgovora

  • RateLimit-Policy

    Ograničenja na snazi, u formatu IETF nacrta draft-ietf-httpapi-ratelimit-headers: stavke odvojene zarezima "<name>";q=<quota>;w=<window in seconds>. key je učestalost zahtjeva API ključa (kvota je nalet, prozor je vrijeme do njegova potpunog obnavljanja; za sesiju je to user, bez vjerodajnica ip); minute, day i month su kvote organizacije za kalendarsku minutu, dan i mjesec po UTC-u.

  • RateLimit

    Što je preostalo od svakog ograničenja u RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    Ograničenje najstrože stavke u RateLimit-Policy (one s najmanje preostalih zahtjeva).

  • X-RateLimit-Remaining

    Preostali zahtjevi u okviru najstrožeg ograničenja.

  • X-RateLimit-Reset

    Broj sekundi do obnove najstrožeg ograničenja.

application/json

Objekt: Error

429Previše zahtjeva (`api.rate_limited`), kvota organizacije za minutu, dan ili mjesec je potrošena (`api.quota_exceeded`; `error.details` sadrži `quota`, `limit` i `reset_at`), dosegnuto je ograničenje organizacije ili je usluga odgovora zauzeta (`answers.engine_busy`). Pričekajte vrijeme navedeno u zaglavlju `Retry-After`.

Zaglavlja odgovora

  • Retry-After

    Broj sekundi koje treba pričekati prije ponovnog pokušaja zahtjeva.

  • RateLimit-Policy

    Ograničenja na snazi, u formatu IETF nacrta draft-ietf-httpapi-ratelimit-headers: stavke odvojene zarezima "<name>";q=<quota>;w=<window in seconds>. key je učestalost zahtjeva API ključa (kvota je nalet, prozor je vrijeme do njegova potpunog obnavljanja; za sesiju je to user, bez vjerodajnica ip); minute, day i month su kvote organizacije za kalendarsku minutu, dan i mjesec po UTC-u.

  • RateLimit

    Što je preostalo od svakog ograničenja u RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    Ograničenje najstrože stavke u RateLimit-Policy (one s najmanje preostalih zahtjeva).

  • X-RateLimit-Remaining

    Preostali zahtjevi u okviru najstrožeg ograničenja.

  • X-RateLimit-Reset

    Broj sekundi do obnove najstrožeg ograničenja.

application/json

Objekt: Error

Kodovi pogrešaka

Kodovi koje ova operacija može vratiti u error.code, uz opće kodove svakog zahtjeva.

Ograničenja učestalosti

Odgovori sadrže zaglavlja RateLimit i RateLimit-Policy te ranija zaglavlja X-RateLimit-Limit, X-RateLimit-Remaining i X-RateLimit-Reset. Odgovor 429 sadrži zaglavlje Retry-After u sekundama: pričekajte i pokušajte ponovno.

← folders · Referenca API-ja