Пређите на садржај
Sursa Developers

GET/v1/cards

Списак картица

list_cards

Враћа картице са филтерима, сортирањем и пагинацијом. Са preview=1 (за приказ плочица) свака картица има и preview (првих 200 знакова текста) и preview_tables (листове са бројем редова), у оквиру вашег профила приступа.

Аутентификација

Пошаљите API кључ у заглављу Authorization: Authorization: Bearer <кључ>.

Параметри упита

  • collectionstring | null
  • folderstring | null

    <folder ID> враћа картице фолдера и свих његових подфолдера. none враћа картице колекције које нису ни у једном фолдеру и захтева collection (у супротном 400 cards.invalid_folder_filter). Ако фолдер не постоји или вам није видљив, захтев враћа 404 folders.not_found.

    length ≤ 64

  • statusstring | null

    Дозвољене вредности: processingreadyerrorarchivedall

  • ownerstring | null

    me, none или ID корисника.

  • owner_idinteger | null
  • verificationstring | null

    Дозвољене вредности: verifiedneeds_verificationstale

  • kindCardKind
  • typestring | null

    table враћа картице са табелама чињеница, text – картице без њих.

    Дозвољене вредности: tabletext

  • tagsstring | null

    Ознаке раздвојене зарезима (картица мора да има све њих).

  • idsstring | null

    Идентификатори картица раздвојени зарезима.

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

    Подразумевано: "created_at"

  • orderstring

    Дозвољене вредности: ascdesc

    Подразумевано: "desc"

  • limitinteger

    Подразумевано: 200

  • offsetinteger

    Подразумевано: 0

  • previewboolean

    true додаје preview (првих 200 знакова) и preview_tables за приказ плочица.

    Подразумевано: false

  • updated_sincestring (date-time)

    Само картице са updated_at у овом тренутку или касније (RFC 3339 са померајем), за синхронизацију. Без експлицитних sort и order листа се сортира по updated_at растуће, затим по id. Обрисане картице се не наводе: брисања стижу као догађаји.

  • metadatamap of string

    Филтер по metadata: metadata[<key>]=<value> – тачно подударање. До 3 услова, и сви морају да буду испуњени (?metadata[team]=support&metadata[crm_id]=A-1042). Више од 3 услова или неисправан кључ враћа 400 api.metadata_invalid.

  • collection_idinteger

    Колекција по идентификатору. Ако је прослеђен и collection, предност има collection_id. За колекцију која не постоји у организацији или није видљива враћа се 404 collections.not_found.

  • external_idstring

    Само картица са овим external_id.

  • cursorstring

    Курсор следеће странице из X-Next-Cursor или next_cursor претходног одговора са истим филтерима; садржи величину странице. Заједно са offset: 422 validation.failed; курсор друге листе, са другим филтерима или неисправан курсор: 400 api.cursor_invalid.

    length ≤ 512

  • expand[]array of string

    Повезани објекти које треба укључити у одговор (од верзије 1.62.0): путања са листе x-expandable операције. Параметар поновите до 10 пута. Путања има до 2 сегмента раздвојена тачком (collection.default_owner). У листи путања почиње са data. и примењује се на сваку ставку странице (expand[]=data.owner). Проширени објекат иде у објекат expanded ставке, а поље са ID остаје. Објекат који позивалац не сме да види према проверама његове сопствене операције читања проширује се као null. Непозната путања, више од 10 путања или путања дубља од 2 сегмента враћа 400 api.expand_invalid.

    items ≤ 10

Параметри заглавља

  • X-View-Asstring

    Само за API кључеве са улогом admin. Извршава захтев у име профила приступа <profile>[:viewer|verifier|editor], на пример employee:viewer. Кључ инсталације не може да користи ово заглавље (403).

Параметри колачића

  • kb_view_asstring

    Колачић режима „View as“ за сесију. POST /auth/view-as га поставља, а DELETE /auth/view-as брише.

Одговори

200Успешан одговор

Заглавља одговора

  • Link

    Адреса следеће странице, <…>; rel="next". Ако заглавља нема, ово је последња страница.

  • X-Next-Cursor

    Курсор следеће странице за параметар cursor. Ако заглавља нема, ово је последња страница.

  • RateLimit-Policy

    Ограничења која важе, у формату IETF нацрта draft-ietf-httpapi-ratelimit-headers: ставке раздвојене зарезима "<name>";q=<quota>;w=<window in seconds>. key је учесталост захтева API кључа (квота је налет, прозор је време за потпуно обнављање; за сесију то је user, без акредитива – ip); minute, day и month су квоте организације за календарски минут, дан и месец по UTC.

  • RateLimit

    Колико је преостало од сваког ограничења из RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    Ограничење најстроже ставке у RateLimit-Policy (оне са најмање преосталих захтева).

  • X-RateLimit-Remaining

    Број преосталих захтева по најстрожем ограничењу.

  • X-RateLimit-Reset

    Број секунди до ресетовања најстрожег ограничења.

application/json

Објекат: CardList

array of Card
  • expandedCardExpanded
  • permissionsObjectPermissionList
  • accessstring

    Дозвољене вредности: wholepartial

  • access_contactstring

    Коме да се обратите за приступ (само када је access=partial).

  • aclobject
    Поља
    • verifybooleanобавезно
    • writebooleanобавезно
  • categorystringобавезно
  • category_confidencenumber | nullобавезно
  • category_lockedbooleanобавезно
  • category_reviewbooleanобавезно
  • category_sourceCategorySource | nullобавезно
  • collectionstringобавезно
  • collection_idintegerобавезно
  • collection_titlestring
  • commentsarray of CardComment
  • content_jsonContentJSON | null

    Садржај уређивача последње објављене верзије. Поље може да изостане; у том случају садржај уређивача преузмите из нацрта (POST /v1/drafts са card_id).

  • editing_lockEditingLock | null

    Активно закључавање за уређивање. Поље може да изостане; у том случају уређивач сазнаје ко држи закључавање из 409 cards.locked на POST /v1/cards/{card_id}/lock.

  • created_atstring (date-time)обавезно
  • days_since_verifiedintegerобавезно
  • errorstring | nullобавезно
  • eventsarray of CardEvent
  • feedback_negintegerобавезно
  • feedback_posintegerобавезно
  • foldersarray of CardFolderRef

    Само у списку картица: фолдери који садрже картицу (они које корисник види), са путањама од корена колекције. Празна листа значи да картица није ни у једном фолдеру.

  • has_tablesboolean

    Само у списку картица.

  • hidden_partsboolean
  • idstringобавезно
  • jobJob | null
  • kindCardKindобавезно
  • org_idintegerобавезно
  • owner_activeboolean | null
  • owner_idinteger | nullобавезно
  • owner_namestring | nullобавезно
  • pagesinteger | nullобавезно
  • parserstring | nullобавезно

    Програм за рашчлањивање документа као неутрални код: document (пуна структура: странице, наслови, табеле, скениране странице), pdf (текстуални слој PDF документа), docx, xlsx, csv, markdown, html, text. Листа може да се прошири.

  • partsarray of CardPartобавезно
  • sensitivebooleanобавезно
  • sha256string | nullобавезно
  • sizeintegerобавезно
  • snoozed_atstring (date-time) | null
  • snoozed_byinteger | null
  • snoozed_untilstring | null
  • source_changedbooleanобавезно
  • source_pathstring | nullобавезно
  • source_urlstring | nullобавезно
  • statusstringобавезно

    Дозвољене вредности: processingreadyerrorarchived

  • tablesarray of CardTable
  • tagsarray of stringобавезно
  • titlestringобавезно
  • trustnumberобавезно
  • trust_if_verifiednumber
  • trust_partsTrustPartsобавезно
  • updated_atstring (date-time)обавезно
  • verificationVerificationобавезно
  • verified_atstring (date-time) | nullобавезно
  • verified_byinteger | nullобавезно
  • verified_by_namestring | null
  • verifier_idsarray of integerобавезно
  • verifiersarray of object
    Поља
    • activebooleanобавезно
    • idintegerобавезно
    • namestringобавезно
  • verify_interval_daysintegerобавезно
  • versionintegerобавезно
  • versionsarray of CardVersion
  • source_archiveArchiveSource
  • created_byinteger | null
  • manual_optionsobject

    Ручна подешавања рашчлањивања (преглед).

  • doc_kindDocKind | null

    Тип документа. null ако тип није одређен (на пример, за картице индексиране пре увођења типова докумената).

  • doc_kind_confidencenumber | null

    Степен поузданости за тип документа, од 0 до 1.

  • doc_kind_sourcestring | null

    Шта је одредило тип: правила (rules), корисник (manual) или аутоматска класификација. Листа може да се прошири: непознату вредност третирајте као аутоматску класификацију.

    Дозвољене вредности: rulesmanualnull

  • invoiceDocInvoiceExtraction | null

    Поља фактуре, књижног одобрења или признанице (само за ове типове и само у картици, не у списку). null ако немате приступ целом документу, јер се поља издвајају из целог документа.

  • warningsarray of ReviewWarning

    Упозорења при рашчлањивању документа (ReviewWarning; само у картици, не у списку).

  • enrichmentCardEnrichmentStatus | null

    Статус обогаћивања (само у картици, не у списку). Тип документа, поља фактуре и финансијски записи додају се у позадини после индексирања и касније могу поново да се израчунају; појављују се у картици када су спремни. null значи да статус није доступан (картица је индексирана без обогаћивања у позадини).

  • external_idstring | null

    ID картице у систему интегратора. Јединствен је у организацији међу картицама које не долазе из извора; null значи да није постављен. /v1/cards-by-external-id/{external_id} по њему чита и замењује картицу.

    length ≤ 512

  • metadataMetadata
400Захтев није исправан: вредност параметра или стање објекта не дозвољава радњу (`detail` је порука).

Заглавља одговора

  • RateLimit-Policy

    Ограничења која важе, у формату IETF нацрта draft-ietf-httpapi-ratelimit-headers: ставке раздвојене зарезима "<name>";q=<quota>;w=<window in seconds>. key је учесталост захтева API кључа (квота је налет, прозор је време за потпуно обнављање; за сесију то је user, без акредитива – ip); minute, day и month су квоте организације за календарски минут, дан и месец по UTC.

  • RateLimit

    Колико је преостало од сваког ограничења из RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    Ограничење најстроже ставке у RateLimit-Policy (оне са најмање преосталих захтева).

  • X-RateLimit-Remaining

    Број преосталих захтева по најстрожем ограничењу.

  • X-RateLimit-Reset

    Број секунди до ресетовања најстрожег ограничења.

application/json

Објекат: Error

401Акредитиви нису послати (ни колачић сесије ни API кључ) или кључ није пронађен.

Заглавља одговора

  • RateLimit-Policy

    Ограничења која важе, у формату IETF нацрта draft-ietf-httpapi-ratelimit-headers: ставке раздвојене зарезима "<name>";q=<quota>;w=<window in seconds>. key је учесталост захтева API кључа (квота је налет, прозор је време за потпуно обнављање; за сесију то је user, без акредитива – ip); minute, day и month су квоте организације за календарски минут, дан и месец по UTC.

  • RateLimit

    Колико је преостало од сваког ограничења из RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    Ограничење најстроже ставке у RateLimit-Policy (оне са најмање преосталих захтева).

  • X-RateLimit-Remaining

    Број преосталих захтева по најстрожем ограничењу.

  • X-RateLimit-Reset

    Број секунди до ресетовања најстрожег ограничења.

application/json

Објекат: Error

403Радња није дозвољена: улога није довољна, нема приступа колекцији или картици, захтев се извршава у режиму „View as“ или је организација суспендована или обрисана (`detail` је објекат са `code: org_suspended | org_deleted`).

Заглавља одговора

  • RateLimit-Policy

    Ограничења која важе, у формату IETF нацрта draft-ietf-httpapi-ratelimit-headers: ставке раздвојене зарезима "<name>";q=<quota>;w=<window in seconds>. key је учесталост захтева API кључа (квота је налет, прозор је време за потпуно обнављање; за сесију то је user, без акредитива – ip); minute, day и month су квоте организације за календарски минут, дан и месец по UTC.

  • RateLimit

    Колико је преостало од сваког ограничења из RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    Ограничење најстроже ставке у RateLimit-Policy (оне са најмање преосталих захтева).

  • X-RateLimit-Remaining

    Број преосталих захтева по најстрожем ограничењу.

  • X-RateLimit-Reset

    Број секунди до ресетовања најстрожег ограничења.

application/json

Објекат: Error

404Објекат не постоји или вам није доступан. API не потврђује да објекат са ограниченим приступом постоји.

Заглавља одговора

  • RateLimit-Policy

    Ограничења која важе, у формату IETF нацрта draft-ietf-httpapi-ratelimit-headers: ставке раздвојене зарезима "<name>";q=<quota>;w=<window in seconds>. key је учесталост захтева API кључа (квота је налет, прозор је време за потпуно обнављање; за сесију то је user, без акредитива – ip); minute, day и month су квоте организације за календарски минут, дан и месец по UTC.

  • RateLimit

    Колико је преостало од сваког ограничења из RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    Ограничење најстроже ставке у RateLimit-Policy (оне са најмање преосталих захтева).

  • X-RateLimit-Remaining

    Број преосталих захтева по најстрожем ограничењу.

  • X-RateLimit-Reset

    Број секунди до ресетовања најстрожег ограничења.

application/json

Објекат: Error

422Грешка валидације: тело или параметри не одговарају шеми (`detail` је листа грешака валидације) или је вредност параметра ван дозвољеног распона (`detail` је порука).

Заглавља одговора

  • RateLimit-Policy

    Ограничења која важе, у формату IETF нацрта draft-ietf-httpapi-ratelimit-headers: ставке раздвојене зарезима "<name>";q=<quota>;w=<window in seconds>. key је учесталост захтева API кључа (квота је налет, прозор је време за потпуно обнављање; за сесију то је user, без акредитива – ip); minute, day и month су квоте организације за календарски минут, дан и месец по UTC.

  • RateLimit

    Колико је преостало од сваког ограничења из RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    Ограничење најстроже ставке у RateLimit-Policy (оне са најмање преосталих захтева).

  • X-RateLimit-Remaining

    Број преосталих захтева по најстрожем ограничењу.

  • X-RateLimit-Reset

    Број секунди до ресетовања најстрожег ограничења.

application/json

Објекат: Error

429Превише захтева (`api.rate_limited`), квота организације за минут, дан или месец је потрошена (`api.quota_exceeded`; `error.details` садржи `quota`, `limit` и `reset_at`), достигнуто је ограничење организације или је сервис за одговоре заузет (`answers.engine_busy`). Сачекајте време наведено у заглављу `Retry-After`.

Заглавља одговора

  • Retry-After

    Број секунди које треба сачекати пре поновног покушаја захтева.

  • RateLimit-Policy

    Ограничења која важе, у формату IETF нацрта draft-ietf-httpapi-ratelimit-headers: ставке раздвојене зарезима "<name>";q=<quota>;w=<window in seconds>. key је учесталост захтева API кључа (квота је налет, прозор је време за потпуно обнављање; за сесију то је user, без акредитива – ip); minute, day и month су квоте организације за календарски минут, дан и месец по UTC.

  • RateLimit

    Колико је преостало од сваког ограничења из RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    Ограничење најстроже ставке у RateLimit-Policy (оне са најмање преосталих захтева).

  • X-RateLimit-Remaining

    Број преосталих захтева по најстрожем ограничењу.

  • X-RateLimit-Reset

    Број секунди до ресетовања најстрожег ограничења.

application/json

Објекат: Error

Кодови грешака

Кодови које ова операција може да врати у error.code, поред општих кодова сваког захтева.

Ограничења учесталости

Одговори садрже заглавља RateLimit и RateLimit-Policy, као и старија X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset. Одговор 429 садржи заглавље Retry-After у секундама: сачекајте и поновите захтев.

← cards · API референца