मुख्य कंटेंट पर जाएँ
Sursa Developers

PATCH/v1/cards/{card_id}

कार्ड बदलें

update_card

ऑथेंटिकेशन

Authorization हेडर में API कुंजी भेजें: Authorization: Bearer <कुंजी>।

पाथ पैरामीटर

  • card_idstringज़रूरी

हेडर पैरामीटर

  • Idempotency-Keystring

    लिखने वाली रिक्वेस्ट के सुरक्षित रीट्राई के लिए कुंजी: 1 से 255 प्रिंट होने वाले ASCII कैरेक्टर; हर लॉजिकल ऑपरेशन के लिए एक UUID v4 की सलाह दी जाती है। उसी कुंजी के साथ 24 घंटे के अंदर रीट्राई ऑपरेशन को दोबारा नहीं चलाता: वह सेव किया गया रिस्पॉन्स (स्टेटस, हेडर और बॉडी) Idempotency-Replayed: true हेडर के साथ लौटाता है। वही कुंजी, पर अलग मेथड, पाथ, Content-Type या बॉडी हो, तो 409 api.idempotency_mismatch लौटता है; जब तक पहली रिक्वेस्ट चल रही है, तब तक 409 api.idempotency_in_progress और Retry-After: 1। 5xx या 429 रिस्पॉन्स के बाद कुंजी छोड़ दी जाती है, और रीट्राई ऑपरेशन को फिर से चलाता है। कुंजी संगठन और कॉल करने वाले (API कुंजी, यूज़र या कस्टम स्रोत की कुंजी) के दायरे में होती है।

    length ≥ 1, length ≤ 255

  • X-View-Asstring

    सिर्फ़ admin रोल वाली API कुंजियों के लिए। रिक्वेस्ट को डेटा प्रोफ़ाइल <profile>[:viewer|verifier|editor] की ओर से चलाता है, जैसे employee:viewer। इंस्टॉलेशन कुंजी इस हेडर का इस्तेमाल नहीं कर सकती (403)।

कुकी पैरामीटर

  • kb_view_asstring

    सेशन के लिए “View as” मोड की कुकी। POST /auth/view-as इसे सेट करता है और DELETE /auth/view-as हटाता है।

रिक्वेस्ट बॉडी

application/json

ऑब्जेक्ट: CardUpdate

  • external_idstring | null

    कार्ड का external_id सेट करता है या बदलता है; "" या null उसे हटा देता है। संगठन का कोई दूसरा कार्ड इसे इस्तेमाल करता हो, तो रिक्वेस्ट 409 cards.external_id_taken लौटाती है। स्रोत के कार्ड का external_id नहीं बदलता (409 cards.managed_by_source)।

    length ≤ 512

  • metadataMetadataPatch
  • titlestring | null
  • owner_idinteger | null
  • verifier_idsarray of integer | null
  • verify_interval_daysinteger | null

    ≥ 1, ≤ 3650

  • tagsarray of string | null
  • statusstring | null
  • source_urlstring | null
  • categorystring | null
  • sensitiveboolean | null
  • table_categoriesmap of object | null

रिस्पॉन्स

200सफल रिस्पॉन्स

रिस्पॉन्स हेडर

  • 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

    सबसे सख़्त सीमा के रीसेट होने तक के सेकंड।

  • Idempotency-Replayed

    true का मतलब है कि रिस्पॉन्स इस Idempotency-Key के लिए सेव किए गए रिस्पॉन्स से दोहराया गया: ऑपरेशन दोबारा नहीं चला।

application/json

ऑब्जेक्ट: 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

    नवीनतम प्रकाशित वर्शन का एडिटर कंटेंट। यह फ़ील्ड न भी हो सकता है; उस स्थिति में एडिटर कंटेंट ड्राफ़्ट से लें (card_id के साथ POST /v1/drafts)।

  • editing_lockEditingLock | null

    एडिटिंग का सक्रिय लॉक। यह फ़ील्ड न भी हो सकता है; उस स्थिति में एडिटर को POST /v1/cards/{card_id}/lock पर मिले 409 cards.locked से पता चलता है कि लॉक किसके पास है।

  • 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 में लौटा सकता है।

सुरक्षित रीट्राई

हर POST और PATCH के साथ Idempotency-Key हेडर भेजें (उदाहरण के लिए, UUID)। 24 घंटे के अंदर उसी कुंजी के साथ रीट्राई करने पर रिक्वेस्ट दोबारा नहीं चलती, बल्कि सेव किया गया रिस्पॉन्स लौटता है।

रेट लिमिट

रिस्पॉन्स में RateLimit और RateLimit-Policy हेडर होते हैं, और पहले वाले X-RateLimit-Limit, X-RateLimit-Remaining और X-RateLimit-Reset भी। 429 रिस्पॉन्स में Retry-After सेकंड में होता है: उतना इंतज़ार करें और रीट्राई करें।

← cards · API रेफ़रेंस