Ugrás a tartalomra
Sursa Developers

POST/v1/cards/{card_id}/verify

Annak megerősítése, hogy a kártya naprakész

verify_card

Hitelesítés

Küldj egy API-kulcsot az Authorization fejlécben: Authorization: Bearer <kulcs>.

Útvonal-paraméterek

  • card_idstringkötelező

Fejlécparaméterek

  • Idempotency-Keystring

    Kulcs egy írási kérés biztonságos megismétléséhez: 1–255 nyomtatható ASCII-karakter; logikai műveletenként egy UUID v4 ajánlott. Ha 24 órán belül ugyanazzal a kulccsal ismétled meg a kérést, a művelet nem fut le újra: a mentett választ kapod vissza (állapot, fejlécek és törzs) az Idempotency-Replayed: true fejléccel. Ugyanaz a kulcs más metódussal, útvonallal, Content-Type értékkel vagy törzzsel 409 api.idempotency_mismatch választ ad; amíg az első kérés még fut, a válasz 409 api.idempotency_in_progress, Retry-After: 1 fejléccel. 5xx vagy 429 válasz után a kulcs felszabadul, és a megismételt kérés újra lefuttatja a műveletet. A kulcs a szervezethez és a hívóhoz (API-kulcs, felhasználó vagy egyéni forrás forráskulcsa) kötődik.

    length ≥ 1, length ≤ 255

  • X-View-Asstring

    Csak admin szerepkörű API-kulcsokhoz. A kérést a <profile>[:viewer|verifier|editor] adatprofil nevében hajtja végre, például employee:viewer. A telepítési kulcs nem használhatja ezt a fejlécet (403).

Cookie-paraméterek

  • kb_view_asstring

    A „View as” mód sütije egy munkamenethez. A POST /auth/view-as beállítja, a DELETE /auth/view-as törli.

Kéréstörzs

application/json

Objektum: VerifyRequest

  • notestring | null

Válaszok

200Sikeres válasz

Válaszfejlécek

  • RateLimit-Policy

    Az érvényben lévő korlátok az IETF draft-ietf-httpapi-ratelimit-headers tervezetének formátumában: vesszővel elválasztott "<name>";q=<quota>;w=<window in seconds> elemek. A key az API-kulcs kérésgyakorisága (a kvóta a csúcskeret, az időablak a teljes visszatöltődés ideje; munkamenetnél user, hitelesítő adatok nélkül ip); a minute, a day és a month a szervezetnek az UTC szerinti naptári percre, napra és hónapra szóló kvótája.

  • RateLimit

    Mennyi maradt a RateLimit-Policy egyes korlátaiból: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    A RateLimit-Policy legszigorúbb elemének korlátja (amelyből a legkevesebb kérés maradt).

  • X-RateLimit-Remaining

    A legszigorúbb korlát szerint még hátralévő kérések száma.

  • X-RateLimit-Reset

    A legszigorúbb korlát visszaállásáig hátralévő másodpercek.

  • Idempotency-Replayed

    A true azt jelenti, hogy a válasz az ehhez az Idempotency-Key kulcshoz mentett válasz megismétlése: a művelet nem futott le újra.

application/json

Objektum: Card

  • expandedCardExpanded
  • permissionsObjectPermissionList
  • accessstring

    Megengedett értékek: wholepartial

  • access_contactstring

    Kihez lehet fordulni hozzáférésért (csak access=partial esetén).

  • aclobject
    Mezők
    • verifybooleankötelező
    • writebooleankötelező
  • categorystringkötelező
  • category_confidencenumber | nullkötelező
  • category_lockedbooleankötelező
  • category_reviewbooleankötelező
  • category_sourceCategorySource | nullkötelező
  • collectionstringkötelező
  • collection_idintegerkötelező
  • collection_titlestring
  • commentsarray of CardComment
  • content_jsonContentJSON | null

    A legutóbb közzétett verzió szerkesztői tartalma. A mező hiányozhat; ilyenkor a szerkesztői tartalmat egy piszkozatból kérd le (POST /v1/drafts a card_id megadásával).

  • editing_lockEditingLock | null

    Aktív szerkesztési zárolás. A mező hiányozhat; ilyenkor a szerkesztő a POST /v1/cards/{card_id}/lock hívásra kapott 409 cards.locked válaszból tudja meg, ki tartja a zárolást.

  • created_atstring (date-time)kötelező
  • days_since_verifiedintegerkötelező
  • errorstring | nullkötelező
  • eventsarray of CardEvent
  • feedback_negintegerkötelező
  • feedback_posintegerkötelező
  • foldersarray of CardFolderRef

    Csak a kártyalistában: a kártyát tartalmazó mappák (a felhasználó számára láthatók), a gyűjtemény gyökerétől számított útvonalukkal. Az üres lista azt jelenti, hogy a kártya egyik mappában sincs.

  • has_tablesboolean

    Csak a kártyalistában.

  • hidden_partsboolean
  • idstringkötelező
  • jobJob | null
  • kindCardKindkötelező
  • org_idintegerkötelező
  • owner_activeboolean | null
  • owner_idinteger | nullkötelező
  • owner_namestring | nullkötelező
  • pagesinteger | nullkötelező
  • parserstring | nullkötelező

    A dokumentum feldolgozója semleges kódként: document (teljes szerkezet: oldalak, címsorok, táblázatok, szkennelt oldalak), pdf (a PDF szövegrétege), docx, xlsx, csv, markdown, html, text. A lista bővülhet.

  • partsarray of CardPartkötelező
  • sensitivebooleankötelező
  • sha256string | nullkötelező
  • sizeintegerkötelező
  • snoozed_atstring (date-time) | null
  • snoozed_byinteger | null
  • snoozed_untilstring | null
  • source_changedbooleankötelező
  • source_pathstring | nullkötelező
  • source_urlstring | nullkötelező
  • statusstringkötelező

    Megengedett értékek: processingreadyerrorarchived

  • tablesarray of CardTable
  • tagsarray of stringkötelező
  • titlestringkötelező
  • trustnumberkötelező
  • trust_if_verifiednumber
  • trust_partsTrustPartskötelező
  • updated_atstring (date-time)kötelező
  • verificationVerificationkötelező
  • verified_atstring (date-time) | nullkötelező
  • verified_byinteger | nullkötelező
  • verified_by_namestring | null
  • verifier_idsarray of integerkötelező
  • verifiersarray of object
    Mezők
    • activebooleankötelező
    • idintegerkötelező
    • namestringkötelező
  • verify_interval_daysintegerkötelező
  • versionintegerkötelező
  • versionsarray of CardVersion
  • source_archiveArchiveSource
  • created_byinteger | null
  • manual_optionsobject

    Kézi feldolgozási beállítások (előnézet).

  • doc_kindDocKind | null

    A dokumentum típusa. null, ha a típus nincs meghatározva (például a dokumentumtípusok bevezetése előtt indexelt kártyáknál).

  • doc_kind_confidencenumber | null

    A dokumentumtípus bizonyossági szintje 0 és 1 között.

  • doc_kind_sourcestring | null

    Mi határozta meg a típust: szabályok (rules), egy felhasználó (manual) vagy automatikus besorolás. A lista bővülhet: az ismeretlen értéket automatikus besorolásként kezeld.

    Megengedett értékek: rulesmanualnull

  • invoiceDocInvoiceExtraction | null

    Számla, jóváíró számla vagy nyugta mezői (csak ezeknél a típusoknál, és csak a kártyában, a listában nem). null, ha nincs hozzáférésed a teljes dokumentumhoz, mert a mezők a teljes dokumentumból származnak.

  • warningsarray of ReviewWarning

    A dokumentum feldolgozásának figyelmeztetései (ReviewWarning; csak a kártyában, a listában nem).

  • enrichmentCardEnrichmentStatus | null

    A gazdagítás állapota (csak a kártyában, a listában nem). A dokumentum típusa, a számla mezői és a pénzügyi rekordok az indexelés után a háttérben kerülnek hozzáadásra, és később újraszámolhatók; amikor elkészülnek, megjelennek a kártyában. A null azt jelenti, hogy nincs elérhető állapot (a kártyát háttérbeli gazdagítás nélkül indexelték).

  • external_idstring | null

    A kártya azonosítója az integrátor rendszerében. A szervezetben egyedi a nem forrásból származó kártyák között; a null azt jelenti, hogy nincs beállítva. A /v1/cards-by-external-id/{external_id} ez alapján olvassa és cseréli a kártyát.

    length ≤ 512

  • metadataMetadata
400A kérés érvénytelen: egy paraméter értéke vagy az objektum állapota nem teszi lehetővé a műveletet (a `detail` egy üzenet).

Válaszfejlécek

  • RateLimit-Policy

    Az érvényben lévő korlátok az IETF draft-ietf-httpapi-ratelimit-headers tervezetének formátumában: vesszővel elválasztott "<name>";q=<quota>;w=<window in seconds> elemek. A key az API-kulcs kérésgyakorisága (a kvóta a csúcskeret, az időablak a teljes visszatöltődés ideje; munkamenetnél user, hitelesítő adatok nélkül ip); a minute, a day és a month a szervezetnek az UTC szerinti naptári percre, napra és hónapra szóló kvótája.

  • RateLimit

    Mennyi maradt a RateLimit-Policy egyes korlátaiból: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    A RateLimit-Policy legszigorúbb elemének korlátja (amelyből a legkevesebb kérés maradt).

  • X-RateLimit-Remaining

    A legszigorúbb korlát szerint még hátralévő kérések száma.

  • X-RateLimit-Reset

    A legszigorúbb korlát visszaállásáig hátralévő másodpercek.

application/json

Objektum: Error

401Nem érkeztek hitelesítő adatok (sem munkamenet-süti, sem API-kulcs), vagy a kulcs nem található.

Válaszfejlécek

  • RateLimit-Policy

    Az érvényben lévő korlátok az IETF draft-ietf-httpapi-ratelimit-headers tervezetének formátumában: vesszővel elválasztott "<name>";q=<quota>;w=<window in seconds> elemek. A key az API-kulcs kérésgyakorisága (a kvóta a csúcskeret, az időablak a teljes visszatöltődés ideje; munkamenetnél user, hitelesítő adatok nélkül ip); a minute, a day és a month a szervezetnek az UTC szerinti naptári percre, napra és hónapra szóló kvótája.

  • RateLimit

    Mennyi maradt a RateLimit-Policy egyes korlátaiból: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    A RateLimit-Policy legszigorúbb elemének korlátja (amelyből a legkevesebb kérés maradt).

  • X-RateLimit-Remaining

    A legszigorúbb korlát szerint még hátralévő kérések száma.

  • X-RateLimit-Reset

    A legszigorúbb korlát visszaállásáig hátralévő másodpercek.

application/json

Objektum: Error

403A művelet nem engedélyezett: a szerepkör nem elegendő, nincs hozzáférés a gyűjteményhez vagy a kártyához, a kérés „View as” módban fut, vagy a szervezetet felfüggesztették vagy törölték (a `detail` egy objektum, `code: org_suspended | org_deleted` mezővel).

Válaszfejlécek

  • RateLimit-Policy

    Az érvényben lévő korlátok az IETF draft-ietf-httpapi-ratelimit-headers tervezetének formátumában: vesszővel elválasztott "<name>";q=<quota>;w=<window in seconds> elemek. A key az API-kulcs kérésgyakorisága (a kvóta a csúcskeret, az időablak a teljes visszatöltődés ideje; munkamenetnél user, hitelesítő adatok nélkül ip); a minute, a day és a month a szervezetnek az UTC szerinti naptári percre, napra és hónapra szóló kvótája.

  • RateLimit

    Mennyi maradt a RateLimit-Policy egyes korlátaiból: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    A RateLimit-Policy legszigorúbb elemének korlátja (amelyből a legkevesebb kérés maradt).

  • X-RateLimit-Remaining

    A legszigorúbb korlát szerint még hátralévő kérések száma.

  • X-RateLimit-Reset

    A legszigorúbb korlát visszaállásáig hátralévő másodpercek.

application/json

Objektum: Error

404Az objektum nem létezik, vagy nem érhető el számodra. Az API nem erősíti meg, hogy egy korlátozott hozzáférésű objektum létezik.

Válaszfejlécek

  • RateLimit-Policy

    Az érvényben lévő korlátok az IETF draft-ietf-httpapi-ratelimit-headers tervezetének formátumában: vesszővel elválasztott "<name>";q=<quota>;w=<window in seconds> elemek. A key az API-kulcs kérésgyakorisága (a kvóta a csúcskeret, az időablak a teljes visszatöltődés ideje; munkamenetnél user, hitelesítő adatok nélkül ip); a minute, a day és a month a szervezetnek az UTC szerinti naptári percre, napra és hónapra szóló kvótája.

  • RateLimit

    Mennyi maradt a RateLimit-Policy egyes korlátaiból: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    A RateLimit-Policy legszigorúbb elemének korlátja (amelyből a legkevesebb kérés maradt).

  • X-RateLimit-Remaining

    A legszigorúbb korlát szerint még hátralévő kérések száma.

  • X-RateLimit-Reset

    A legszigorúbb korlát visszaállásáig hátralévő másodpercek.

application/json

Objektum: Error

422Érvényesítési hiba: a törzs vagy a paraméterek nem felelnek meg a sémának (a `detail` az érvényesítési hibák listája), vagy egy paraméter értéke kívül esik a megengedett tartományon (a `detail` egy üzenet).

Válaszfejlécek

  • RateLimit-Policy

    Az érvényben lévő korlátok az IETF draft-ietf-httpapi-ratelimit-headers tervezetének formátumában: vesszővel elválasztott "<name>";q=<quota>;w=<window in seconds> elemek. A key az API-kulcs kérésgyakorisága (a kvóta a csúcskeret, az időablak a teljes visszatöltődés ideje; munkamenetnél user, hitelesítő adatok nélkül ip); a minute, a day és a month a szervezetnek az UTC szerinti naptári percre, napra és hónapra szóló kvótája.

  • RateLimit

    Mennyi maradt a RateLimit-Policy egyes korlátaiból: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    A RateLimit-Policy legszigorúbb elemének korlátja (amelyből a legkevesebb kérés maradt).

  • X-RateLimit-Remaining

    A legszigorúbb korlát szerint még hátralévő kérések száma.

  • X-RateLimit-Reset

    A legszigorúbb korlát visszaállásáig hátralévő másodpercek.

application/json

Objektum: Error

429Túl sok kérés (`api.rate_limited`), elfogyott a szervezet percre, napra vagy hónapra szóló kvótája (`api.quota_exceeded`; az `error.details` a `quota`, a `limit` és a `reset_at` mezőt tartalmazza), a szervezet elérte a korlátját, vagy a válaszszolgáltatás foglalt (`answers.engine_busy`). Várj a `Retry-After` fejlécben megadott ideig.

Válaszfejlécek

  • Retry-After

    Ennyi másodpercet várj, mielőtt újrapróbálod a kérést.

  • RateLimit-Policy

    Az érvényben lévő korlátok az IETF draft-ietf-httpapi-ratelimit-headers tervezetének formátumában: vesszővel elválasztott "<name>";q=<quota>;w=<window in seconds> elemek. A key az API-kulcs kérésgyakorisága (a kvóta a csúcskeret, az időablak a teljes visszatöltődés ideje; munkamenetnél user, hitelesítő adatok nélkül ip); a minute, a day és a month a szervezetnek az UTC szerinti naptári percre, napra és hónapra szóló kvótája.

  • RateLimit

    Mennyi maradt a RateLimit-Policy egyes korlátaiból: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    A RateLimit-Policy legszigorúbb elemének korlátja (amelyből a legkevesebb kérés maradt).

  • X-RateLimit-Remaining

    A legszigorúbb korlát szerint még hátralévő kérések száma.

  • X-RateLimit-Reset

    A legszigorúbb korlát visszaállásáig hátralévő másodpercek.

application/json

Objektum: Error

Hibakódok

Azok a kódok, amelyeket ez a végpont hiba esetén az error.code mezőben visszaadhat, a minden kérésre érvényes általános kódokon kívül.

Biztonságos újrapróbálkozás

Minden POST és PATCH kéréssel küldj Idempotency-Key fejlécet (például egy UUID-t). Ha 24 órán belül ugyanazzal a kulccsal megismétled a kérést, a mentett választ kapod vissza, és a kérés nem fut le újra.

Gyakorisági korlátok

A válaszokban ott van a RateLimit és a RateLimit-Policy fejléc, valamint a korábbi X-RateLimit-Limit, X-RateLimit-Remaining és X-RateLimit-Reset fejléc. A 429-es válasz Retry-After fejléce másodpercben adja meg a várakozást: várj, majd próbáld újra.

← cards · API-referencia