Hoppa till innehållet
Sursa Developers

GET/v1/cards

Lista kort

list_cards

Returnerar kort med filter, sortering och sidindelning. Med preview=1 (för rutnätsvyn) har varje kort också preview (de första 200 tecknen av texten) och preview_tables (blad med antal rader), inom din dataprofil.

Autentisering

Skicka en API-nyckel i huvudet Authorization: Authorization: Bearer <nyckel>.

Frågeparametrar

  • collectionstring | null
  • folderstring | null

    <folder ID> returnerar korten i mappen och alla dess undermappar. none returnerar de kort i samlingen som inte ligger i någon mapp och kräver collection (annars 400 cards.invalid_folder_filter). Om mappen inte finns eller inte är synlig för dig returnerar anropet 404 folders.not_found.

    length ≤ 64

  • statusstring | null

    Tillåtna värden: processingreadyerrorarchivedall

  • ownerstring | null

    me, none eller en användares id.

  • owner_idinteger | null
  • verificationstring | null

    Tillåtna värden: verifiedneeds_verificationstale

  • kindCardKind
  • typestring | null

    table returnerar kort med faktatabeller, text returnerar kort utan sådana.

    Tillåtna värden: tabletext

  • tagsstring | null

    Kommaseparerade taggar (ett kort måste ha alla).

  • idsstring | null

    Kommaseparerade kort-id:n.

  • searchstring | null
  • categorystring | null
  • sensitiveboolean | null
  • sortCardSort

    Standard: "created_at"

  • orderstring

    Tillåtna värden: ascdesc

    Standard: "desc"

  • limitinteger

    Standard: 200

  • offsetinteger

    Standard: 0

  • previewboolean

    true lägger till preview (de första 200 tecknen) och preview_tables för rutnätsvyn.

    Standard: false

  • updated_sincestring (date-time)

    Bara kort med updated_at vid eller efter den här tidpunkten (RFC 3339 med tidszonsförskjutning), för synkning. Utan uttryckliga sort och order sorteras listan efter updated_at i stigande ordning och sedan efter id. Borttagna kort listas inte: borttagningar kommer som händelser.

  • metadatamap of string

    Filter på metadata: metadata[<key>]=<value> ger exakt matchning. Upp till 3 villkor, och alla måste uppfyllas (?metadata[team]=support&metadata[crm_id]=A-1042). Fler än 3 villkor eller en ogiltig nyckel returnerar 400 api.metadata_invalid.

  • collection_idinteger

    Samling efter id. Om collection också skickas har collection_id företräde. En samling som inte finns i organisationen eller inte är synlig ger 404 collections.not_found.

  • external_idstring

    Bara kortet med detta external_id.

  • cursorstring

    Markör för nästa sida från X-Next-Cursor eller next_cursor i föregående svar med samma filter; den bär med sig sidstorleken. Tillsammans med offset: 422 validation.failed; en markör från en annan lista, med andra filter eller en felformaterad markör: 400 api.cursor_invalid.

    length ≤ 512

  • expand[]array of string

    Relaterade objekt att ta med i svaret (sedan 1.62.0): en sökväg från åtgärdens lista x-expandable. Upprepa parametern upp till 10 gånger. En sökväg har upp till 2 segment åtskilda med en punkt (collection.default_owner). I en lista börjar sökvägen med data. och gäller varje element på sidan (expand[]=data.owner). Ett expanderat objekt hamnar i elementets objekt expanded, och id-fältet står kvar. Ett objekt som anroparen inte får se enligt kontrollerna i dess egen läsåtgärd expanderas som null. En okänd sökväg, fler än 10 sökvägar eller en sökväg djupare än 2 segment returnerar 400 api.expand_invalid.

    items ≤ 10

Parametrar i huvuden

  • X-View-Asstring

    Bara för API-nycklar med rollen admin. Gör anropet som dataprofilen <profile>[:viewer|verifier|editor], till exempel employee:viewer. Installationsnyckeln kan inte använda det här huvudet (403).

Cookie-parametrar

  • kb_view_asstring

    Cookie för läget ”View as” (visa som en annan användare) i en session. POST /auth/view-as sätter den och DELETE /auth/view-as tar bort den.

Svar

200Lyckat svar

Svarshuvuden

  • Link

    Adressen till nästa sida, <…>; rel="next". Saknas huvudet är det här den sista sidan.

  • X-Next-Cursor

    Markör för nästa sida för parametern cursor. Saknas huvudet är det här den sista sidan.

  • RateLimit-Policy

    Gällande gränser i formatet från IETF-utkastet draft-ietf-httpapi-ratelimit-headers: kommaseparerade poster "<name>";q=<quota>;w=<window in seconds>. key är API-nyckelns anropsfrekvens (kvoten är toppen (burst), fönstret är tiden tills den har fyllts på helt; för en session är det user, utan autentiseringsuppgifter ip); minute, day och month är organisationens kvoter för kalenderminuten, kalenderdygnet och kalendermånaden i UTC.

  • RateLimit

    Vad som återstår av varje gräns i RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    Gränsen för den striktaste posten i RateLimit-Policy (den med minst antal återstående anrop).

  • X-RateLimit-Remaining

    Återstående anrop inom den striktaste gränsen.

  • X-RateLimit-Reset

    Sekunder tills den striktaste gränsen nollställs.

application/json

Objekt: CardList

array of Card
  • expandedCardExpanded
  • permissionsObjectPermissionList
  • accessstring

    Tillåtna värden: wholepartial

  • access_contactstring

    Vem man kontaktar för åtkomst (bara när access=partial).

  • aclobject
    Fält
    • verifybooleanobligatorisk
    • writebooleanobligatorisk
  • categorystringobligatorisk
  • category_confidencenumber | nullobligatorisk
  • category_lockedbooleanobligatorisk
  • category_reviewbooleanobligatorisk
  • category_sourceCategorySource | nullobligatorisk
  • collectionstringobligatorisk
  • collection_idintegerobligatorisk
  • collection_titlestring
  • commentsarray of CardComment
  • content_jsonContentJSON | null

    Innehåll för textredigeraren i den senaste publicerade versionen. Fältet kan saknas; hämta i så fall redigerarens innehåll från ett utkast (POST /v1/drafts med card_id).

  • editing_lockEditingLock | null

    Aktivt redigeringslås. Fältet kan saknas; i så fall får den som redigerar veta vem som har låset genom 409 cards.locked på POST /v1/cards/{card_id}/lock.

  • created_atstring (date-time)obligatorisk
  • days_since_verifiedintegerobligatorisk
  • errorstring | nullobligatorisk
  • eventsarray of CardEvent
  • feedback_negintegerobligatorisk
  • feedback_posintegerobligatorisk
  • foldersarray of CardFolderRef

    Bara i kortlistan: mapparna som innehåller kortet (de som användaren ser), med sina sökvägar från samlingens rotnivå. En tom lista betyder att kortet inte ligger i någon mapp.

  • has_tablesboolean

    Bara i kortlistan.

  • hidden_partsboolean
  • idstringobligatorisk
  • jobJob | null
  • kindCardKindobligatorisk
  • org_idintegerobligatorisk
  • owner_activeboolean | null
  • owner_idinteger | nullobligatorisk
  • owner_namestring | nullobligatorisk
  • pagesinteger | nullobligatorisk
  • parserstring | nullobligatorisk

    Dokumentets tolk som neutral kod: document (fullständig struktur: sidor, rubriker, tabeller, skannade sidor), pdf (PDF-filens textlager), docx, xlsx, csv, markdown, html, text. Listan kan utökas.

  • partsarray of CardPartobligatorisk
  • sensitivebooleanobligatorisk
  • sha256string | nullobligatorisk
  • sizeintegerobligatorisk
  • snoozed_atstring (date-time) | null
  • snoozed_byinteger | null
  • snoozed_untilstring | null
  • source_changedbooleanobligatorisk
  • source_pathstring | nullobligatorisk
  • source_urlstring | nullobligatorisk
  • statusstringobligatorisk

    Tillåtna värden: processingreadyerrorarchived

  • tablesarray of CardTable
  • tagsarray of stringobligatorisk
  • titlestringobligatorisk
  • trustnumberobligatorisk
  • trust_if_verifiednumber
  • trust_partsTrustPartsobligatorisk
  • updated_atstring (date-time)obligatorisk
  • verificationVerificationobligatorisk
  • verified_atstring (date-time) | nullobligatorisk
  • verified_byinteger | nullobligatorisk
  • verified_by_namestring | null
  • verifier_idsarray of integerobligatorisk
  • verifiersarray of object
    Fält
    • activebooleanobligatorisk
    • idintegerobligatorisk
    • namestringobligatorisk
  • verify_interval_daysintegerobligatorisk
  • versionintegerobligatorisk
  • versionsarray of CardVersion
  • source_archiveArchiveSource
  • created_byinteger | null
  • manual_optionsobject

    Manuella inställningar för tolkningen (förhandsvisning).

  • doc_kindDocKind | null

    Dokumenttyp. null om typen inte har fastställts (till exempel för kort som indexerades innan dokumenttyper infördes).

  • doc_kind_confidencenumber | null

    Konfidens för dokumenttypen, från 0 till 1.

  • doc_kind_sourcestring | null

    Vad som avgjorde typen: regler (rules), en användare (manual) eller automatisk klassificering. Listan kan utökas: behandla ett okänt värde som automatisk klassificering.

    Tillåtna värden: rulesmanualnull

  • invoiceDocInvoiceExtraction | null

    Fält för en faktura, kreditfaktura eller ett kvitto (bara för dessa typer och bara i kortet, inte i listan). null om du inte har åtkomst till hela dokumentet, eftersom fälten hämtas ur hela dokumentet.

  • warningsarray of ReviewWarning

    Varningar från tolkningen av dokumentet (ReviewWarning; bara i kortet, inte i listan).

  • enrichmentCardEnrichmentStatus | null

    Berikningsstatus (bara i kortet, inte i listan). Dokumenttypen, fakturafälten och de finansiella posterna läggs till i bakgrunden efter indexeringen och kan räknas om senare; de visas i kortet när de är klara. null betyder att ingen status finns (kortet indexerades utan berikning i bakgrunden).

  • external_idstring | null

    Kortets id i integratörens system. Det är unikt i organisationen bland kort som inte kommer från källor; null betyder att det inte är angivet. /v1/cards-by-external-id/{external_id} läser och ersätter kortet med hjälp av det.

    length ≤ 512

  • metadataMetadata
400Anropet är ogiltigt: ett parametervärde eller objektets tillstånd tillåter inte åtgärden (`detail` är ett meddelande).

Svarshuvuden

  • RateLimit-Policy

    Gällande gränser i formatet från IETF-utkastet draft-ietf-httpapi-ratelimit-headers: kommaseparerade poster "<name>";q=<quota>;w=<window in seconds>. key är API-nyckelns anropsfrekvens (kvoten är toppen (burst), fönstret är tiden tills den har fyllts på helt; för en session är det user, utan autentiseringsuppgifter ip); minute, day och month är organisationens kvoter för kalenderminuten, kalenderdygnet och kalendermånaden i UTC.

  • RateLimit

    Vad som återstår av varje gräns i RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    Gränsen för den striktaste posten i RateLimit-Policy (den med minst antal återstående anrop).

  • X-RateLimit-Remaining

    Återstående anrop inom den striktaste gränsen.

  • X-RateLimit-Reset

    Sekunder tills den striktaste gränsen nollställs.

application/json

Objekt: Error

401Inga autentiseringsuppgifter skickades (varken en sessionscookie eller en API-nyckel), eller så hittades inte nyckeln.

Svarshuvuden

  • RateLimit-Policy

    Gällande gränser i formatet från IETF-utkastet draft-ietf-httpapi-ratelimit-headers: kommaseparerade poster "<name>";q=<quota>;w=<window in seconds>. key är API-nyckelns anropsfrekvens (kvoten är toppen (burst), fönstret är tiden tills den har fyllts på helt; för en session är det user, utan autentiseringsuppgifter ip); minute, day och month är organisationens kvoter för kalenderminuten, kalenderdygnet och kalendermånaden i UTC.

  • RateLimit

    Vad som återstår av varje gräns i RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    Gränsen för den striktaste posten i RateLimit-Policy (den med minst antal återstående anrop).

  • X-RateLimit-Remaining

    Återstående anrop inom den striktaste gränsen.

  • X-RateLimit-Reset

    Sekunder tills den striktaste gränsen nollställs.

application/json

Objekt: Error

403Åtgärden är inte tillåten: rollen räcker inte, det saknas åtkomst till samlingen eller kortet, anropet körs i läget ”View as” (visa som en annan användare), eller organisationen är avstängd eller borttagen (`detail` är ett objekt med `code: org_suspended | org_deleted`).

Svarshuvuden

  • RateLimit-Policy

    Gällande gränser i formatet från IETF-utkastet draft-ietf-httpapi-ratelimit-headers: kommaseparerade poster "<name>";q=<quota>;w=<window in seconds>. key är API-nyckelns anropsfrekvens (kvoten är toppen (burst), fönstret är tiden tills den har fyllts på helt; för en session är det user, utan autentiseringsuppgifter ip); minute, day och month är organisationens kvoter för kalenderminuten, kalenderdygnet och kalendermånaden i UTC.

  • RateLimit

    Vad som återstår av varje gräns i RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    Gränsen för den striktaste posten i RateLimit-Policy (den med minst antal återstående anrop).

  • X-RateLimit-Remaining

    Återstående anrop inom den striktaste gränsen.

  • X-RateLimit-Reset

    Sekunder tills den striktaste gränsen nollställs.

application/json

Objekt: Error

404Objektet finns inte eller är inte tillgängligt för dig. API:et bekräftar inte att ett begränsat objekt finns.

Svarshuvuden

  • RateLimit-Policy

    Gällande gränser i formatet från IETF-utkastet draft-ietf-httpapi-ratelimit-headers: kommaseparerade poster "<name>";q=<quota>;w=<window in seconds>. key är API-nyckelns anropsfrekvens (kvoten är toppen (burst), fönstret är tiden tills den har fyllts på helt; för en session är det user, utan autentiseringsuppgifter ip); minute, day och month är organisationens kvoter för kalenderminuten, kalenderdygnet och kalendermånaden i UTC.

  • RateLimit

    Vad som återstår av varje gräns i RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    Gränsen för den striktaste posten i RateLimit-Policy (den med minst antal återstående anrop).

  • X-RateLimit-Remaining

    Återstående anrop inom den striktaste gränsen.

  • X-RateLimit-Reset

    Sekunder tills den striktaste gränsen nollställs.

application/json

Objekt: Error

422Valideringsfel: brödtexten eller parametrarna stämmer inte med schemat (`detail` är en lista med valideringsfel), eller så ligger ett parametervärde utanför det tillåtna intervallet (`detail` är ett meddelande).

Svarshuvuden

  • RateLimit-Policy

    Gällande gränser i formatet från IETF-utkastet draft-ietf-httpapi-ratelimit-headers: kommaseparerade poster "<name>";q=<quota>;w=<window in seconds>. key är API-nyckelns anropsfrekvens (kvoten är toppen (burst), fönstret är tiden tills den har fyllts på helt; för en session är det user, utan autentiseringsuppgifter ip); minute, day och month är organisationens kvoter för kalenderminuten, kalenderdygnet och kalendermånaden i UTC.

  • RateLimit

    Vad som återstår av varje gräns i RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    Gränsen för den striktaste posten i RateLimit-Policy (den med minst antal återstående anrop).

  • X-RateLimit-Remaining

    Återstående anrop inom den striktaste gränsen.

  • X-RateLimit-Reset

    Sekunder tills den striktaste gränsen nollställs.

application/json

Objekt: Error

429För många anrop (`api.rate_limited`), organisationens kvot för minuten, dygnet eller månaden är förbrukad (`api.quota_exceeded`; `error.details` innehåller `quota`, `limit` och `reset_at`), organisationens gräns är nådd eller svarstjänsten är upptagen (`answers.engine_busy`). Vänta den tid som anges i huvudet `Retry-After`.

Svarshuvuden

  • Retry-After

    Antal sekunder att vänta innan du skickar anropet igen.

  • RateLimit-Policy

    Gällande gränser i formatet från IETF-utkastet draft-ietf-httpapi-ratelimit-headers: kommaseparerade poster "<name>";q=<quota>;w=<window in seconds>. key är API-nyckelns anropsfrekvens (kvoten är toppen (burst), fönstret är tiden tills den har fyllts på helt; för en session är det user, utan autentiseringsuppgifter ip); minute, day och month är organisationens kvoter för kalenderminuten, kalenderdygnet och kalendermånaden i UTC.

  • RateLimit

    Vad som återstår av varje gräns i RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    Gränsen för den striktaste posten i RateLimit-Policy (den med minst antal återstående anrop).

  • X-RateLimit-Remaining

    Återstående anrop inom den striktaste gränsen.

  • X-RateLimit-Reset

    Sekunder tills den striktaste gränsen nollställs.

application/json

Objekt: Error

Felkoder

Koder som den här slutpunkten kan returnera i error.code, utöver de allmänna koderna för alla anrop.

Hastighetsbegränsningar

Svaren innehåller huvudena RateLimit och RateLimit-Policy samt de tidigare X-RateLimit-Limit, X-RateLimit-Remaining och X-RateLimit-Reset. Ett 429-svar har Retry-After i sekunder: vänta och försök igen.

← cards · API-referens