Objektit
PushDocument
Kentät
external_idstringpakollinenAsiakirjan pysyvä tunnus järjestelmässäsi. Saman tunnuksen lähettäminen korvaa asiakirjan.
length ≤ 512
titlestringpakollinenlength ≤ 500
urlstringLinkki asiakirjaan järjestelmässäsi (http tai https).
contentstringSisältö (enintään 5 Mt).
content_typestringSallitut arvot:
htmlmarkdowntextOletus: "html"
patharray of string | stringAsiakirjan kansiot: nimien taulukko tai merkkijono, jossa erottimena on ”/” (enintään 10 tasoa).
permissionsPushPermissionstagsarray of stringitems ≤ 50
author_emailstringTekijä. Tulee kortin omistajaksi, jos hän on Sursan käyttäjä.
updated_atstring (date-time)Muokkausaika järjestelmässäsi (osa asiakirjan versiota).
metadataMetadataPatchAsiakirjan kortin
metadata(versiosta 1.62.0 alkaen): objekti korvaa kortin aiemmat metatiedot,{}poistaa kaikki parit; ilmanmetadata-kenttää kortin metatiedot eivät muutu.categorystringKortin luokka: organisaation luokan avain (
GET /v1/categories), versiosta 1.62.0 alkaen.length ≤ 64
verifiersPushVerifiersverify_interval_daysintegerKortin vahvistusväli päivinä (versiosta 1.62.0 alkaen); ilman sitä käytetään lähteen väliä.
≥ 1, ≤ 3650
upload_idstringAsiakirjan tiedosto moniosaisesta latauksesta (
upl_…, versiosta 1.62.0 alkaen)content-kentän sijaan. Latauksen voi käyttää kerran; saman asiakirjan lähettäminen uudelleen samallaupload_id-tunnuksella ei kuluta sitä. Niin kauan kuin moniosaiset lataukset eivät ole käytettävissä asennuksessa, asiakirja hylätään syylläfile_rejected.length ≤ 64
attachmentsarray of stringAsiakirjan liitteet moniosaisina latauksina (
upl_…, versiosta 1.62.0 alkaen): kustakin tulee lähteen oma kortti, jolla on sama kansio, samat käyttöoikeudet ja samat kortin kentät. Liite, joka puuttuu asiakirjan uudesta versiosta, arkistoidaan.items ≤ 20