Μετάβαση στο περιεχόμενο
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

  • typestring | null

    Το table επιστρέφει κάρτες με πίνακες γεγονότων, το text – κάρτες χωρίς αυτούς.

    Επιτρεπόμενες τιμές: tabletext

  • tagsstring | null

    Ετικέτες χωρισμένες με κόμμα (η κάρτα πρέπει να τις έχει όλες).

  • idsstring | null

    ID καρτών χωρισμένα με κόμμα.

  • searchstring | null
  • categorystring | null
  • sensitiveboolean | null
  • Προεπιλογή: "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

    Συλλογή με βάση το ID. Όταν δίνεται και το 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 παραμένει. Ένα αντικείμενο που ο πελάτης που καλεί το API δεν επιτρέπεται να δει σύμφωνα με τους ελέγχους της δικής του λειτουργίας ανάγνωσης αναπτύσσεται ως null. Μια άγνωστη διαδρομή, περισσότερες από 10 διαδρομές ή μια διαδρομή βαθύτερη από 2 τμήματα επιστρέφει 400 api.expand_invalid.

    items ≤ 10

Παράμετροι κεφαλίδας

  • X-View-Asstring

    Μόνο για κλειδιά API με τον ρόλο admin. Εκτελεί το αίτημα ως το προφίλ δεδομένων <profile>[:viewer|verifier|editor], για παράδειγμα employee:viewer. Το κλειδί εγκατάστασης δεν μπορεί να χρησιμοποιήσει αυτή την κεφαλίδα (403).

Παράμετροι cookie

  • kb_view_asstring

    Cookie της λειτουργίας «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
  • 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

    Δευτερόλεπτα έως τον μηδενισμό του αυστηρότερου ορίου.

401Δεν στάλθηκαν διαπιστευτήρια (ούτε cookie συνεδρίας ούτε κλειδί 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

    Δευτερόλεπτα έως τον μηδενισμό του αυστηρότερου ορίου.

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

    Δευτερόλεπτα έως τον μηδενισμό του αυστηρότερου ορίου.

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

    Δευτερόλεπτα έως τον μηδενισμό του αυστηρότερου ορίου.

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

    Δευτερόλεπτα έως τον μηδενισμό του αυστηρότερου ορίου.

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

    Δευτερόλεπτα έως τον μηδενισμό του αυστηρότερου ορίου.

Κωδικοί σφαλμάτων

Κωδικοί που μπορεί να επιστρέψει αυτό το τελικό σημείο στο error.code, εκτός από τους γενικούς κωδικούς κάθε αιτήματος.

Όρια ρυθμού

Οι αποκρίσεις περιέχουν τις κεφαλίδες RateLimit και RateLimit-Policy, καθώς και τις παλαιότερες X-RateLimit-Limit, X-RateLimit-Remaining και X-RateLimit-Reset. Μια απόκριση 429 έχει την κεφαλίδα Retry-After σε δευτερόλεπτα: περιμένετε και επαναλάβετε το αίτημα.

← cards · Αναφορά API