Brukerveiledning Avbryt

API for Adobe Acrobat Sign – vanlige spørsmål

 

Veiledning for Adobe Acrobat Sign

Nyheter

  1. Merknader før utgivelse
  2. Produktmerknader
  3. Viktige varsler

Kom i gang

  1. Hurtigstartveiledning for administratorer
  2. Hurtigstartveiledning for brukere
  3. For utviklere
  4. Videoopplæringsbibliotek
  5. Vanlige spørsmål

Administrer

  1. Oversikt over Admin Console
  2. Brukeradministrasjon
    1. Legge til brukere
      1. Legge til en bruker
      2. Opprette brukere samlet
      3. Legge til brukere fra katalogen din
      4. Legge til brukere fra MS Azure Active Directory
    2. Lage funksjonsfokuserte brukere
      1. Tekniske kontoer – API-styrt
      2. Servicekontoer – Manuell styring
    3. Se etter brukere med klargjøringsfeil
    4. Endre navn/e-postadresse
    5. Redigere en brukers gruppemedlemskap
    6. Redigere en brukers gruppemedlemskap gjennom gruppegrensesnittet
    7. Forfremme en bruker til en administratorrolle
    8. Brukeridentitetstyper og SSO
    9. Bytte brukeridentitet
    10. Autentisere brukere med MS Azure
    11. Autentisere brukere med Google-føderasjon
    12. Produktprofiler
    13. Påloggingsopplevelse 
  3. Innstillinger for konto/gruppe
    1. Innstillingsoversikt
    2. Globale innstillinger
      1. Kontonivå og ID
      2. Ny mottakeropplevelse
      3. Selvsigneringsarbeidsflyter
      4. Send samlet
      5. Nettskjemaer
      6. Tilpassede arbeidsflyter for sending
      7. Power Automate-arbeidsflyter
      8. Biblioteksdokumenter
      9. Samle inn skjemadata med avtaler
      10. Begrenset dokumentsynlighet
      11. Legge ved en PDF-kopi av den signerte avtalen 
      12. Inkludere en kobling i e-posten
      13. Inkludere et bilde i e-postmeldingen
      14. Filer vedlagt e-post navngis som
      15. Legge ved revisjonsrapporter til dokumenter
      16. Slå sammen flere dokumenter til ett dokument
      17. Last ned enkeltdokumenter
      18. Laste opp signert dokument
      19. Delegering for brukere i kontoen min
      20. Tillate eksterne mottakere å delegere
      21. Myndighet til å signere
      22. Myndighet til å sende
      23. Rett til å legge til elektroniske segl
      24. Angi en standard tidssone
      25. Angi et standard datoformat
      26. Brukere i flere grupper
        1. Oppgrader for å bruke UMG
      27. Administratortillatelser for grupper
      28. Erstatte mottaker
      29. Revisjonsrapport
        1. Oversikt
        2. Tillate uautorisert tilgang på transaksjonsbekreftelsessiden
        3. Inkludere påminnelser
        4. Inkludere visningshendelser
        5. Inkludere avtaleside / antall vedlegg
      30. Transaksjonsbunntekst
      31. I produktmeldinger og veiledning
      32. Tilgjengelige PDF-er
      33. Ny redigeringsopplevelse
      34. Kunde i helsevesenet
    3. Kontooppsett
      1. Legge til logo
      2. Tilpasse firmaets vertsnavn/nettadresse    
      3. Legge til firmanavn
      4. Nettadresseomdirigeringer etter avtale
    4. Signaturpreferanser
      1. Riktig formaterte signaturer
      2. La mottakere signere ved å
      3. Underskrivere kan endre navn
      4. La mottakere bruke den lagrede signaturen sin
      5. Tilpassede vilkår for bruk og forbrukerinformasjon
      6. Led mottakerne gjennom skjemafelt
      7. Start avtalens arbeidsflyt på nytt
      8. Avslå å signere
      9. Tillat Stempler-arbeidsflyt
      10. Krev at underskrivere angir stilling eller firma
      11. La underskrivere skrive ut og plassere en skriftlig signatur
      12. Vis meldinger ved e-signering
      13. Krev at underskrivere bruker en mobilenhet til å opprette sin signatur
      14. Be om IP-adresse fra underskrivere
      15. Utelat firmanavn og tittel fra deltakelsesstempler
    5. Digitale signaturer
      1. Oversikt
      2. Laste ned og signere med Acrobat
      3. Signere med skysignaturer
      4. Inkluder metadata for identitetsleverandører
      5. Begrensede skysignaturtilbydere
    6. Elektroniske segl
    7. Digital identitet
      1. Gateway for digital identitet
      2. Policy for identitetskontroll
    8. Rapportinnstillinger
      1. Ny rapportopplevelse
      2. Klassiske rapportinnstillinger
    9. Sikkerhetsinnstillinger
      1. Innstillinger for enkeltpålogging
      2. Innstillinger for Husk meg
      3. Policy for innloggingspassord
      4. Styrke på innloggingspassordet
      5. Varighet på nettøkt
      6. PDF-krypteringstype
      7. API
      8. Tilgang for bruker- og gruppeinformasjon
      9. Tillatte IP-serier
      10. Kontodeling
      11. Tillatelser for kontodeling
      12. Avtalens delingskontroller
      13. Bekreftelse av underskriveridentitet
      14. Signeringspassord for avtale
      15. Styrke på dokumentpassord
      16. Blokker underskrivere etter geografisk plassering
      17. Telefongodkjenning
      18. Kunnskapsbasert godkjenning (KBA)
      19. Tillat uttrekking av side
      20. Utløp for dokumentlenke
      21. Last opp et klientsertifikat for webhook/tilbakekall
      22. Tidsstempel
    10. Send-innstillinger
      1. Vis Send-siden etter pålogging
      2. Krev mottakernavn ved sending
      3. Lås navneverdier for kjente brukere
      4. Tillatte mottakerroller
      5. Tillat e-vitner
      6. Mottakergrupper
      7. Kopimottakere
      8. Tilgang til mottakeravtale
      9. Obligatoriske felt
      10. Legge ved dokumenter
      11. Feltutflating
      12. Endre avtaler
      13. Avtalenavn
      14. Språk
      15. Private meldinger
      16. Tillatte signaturtyper
      17. Påminnelser
      18. Passordbeskyttelse for signert dokument
      19. Send avtalevarsel gjennom
      20. Alternativer for underskriveridentifikasjon
        1. Oversikt
        2. Signeringspassord
        3. Engangspassord via e-post
        4. Acrobat Sign-godkjenning
        5. Telefongodkjenning
        6. Skybasert digital signatur
        7. Kunnskapsbasert godkjenning
        8. Myndighets-ID
        9. Underskriveridentitetsrapporter
      21. Innholdsbeskyttelse
      22. Aktiver Notarize-transaksjoner
      23. Dokumentutløp
      24. Forhåndsvis, plasser signaturer og legg til felt
      25. Sigeringsrekkefølge
      26. Liquid Mode
      27. Tilpassede arbeidsflytkontroller
      28. Opplastingsalternativer for e-signeringssiden
      29. Omdirigering til nettadresse for bekreftelse etter signering
    11. Meldingsmaler
    12. Bio-Pharma-innstillinger
      1. Oversikt
      2. Håndhev identitetsgodkjenning
      3. Årsaker til signering
    13. Arbeidsflytintegrasjon
    14. Innstillinger for notarisering
    15. Betalingsintegrering
    16. Underskrivermelding
    17. SAML-innstillinger
      1. SAML-konfigurasjon
      2. Installer Microsoft Active Directory Federation Service
      3. Installer Okta
      4. Installer OneLogin
      5. Installer Oracle Identity Federation
    18. Datastyring
    19. Tidsstempelinnstillinger
    20. Eksternt arkiv
    21. Kontospråk
    22. E-post-innstillinger
      1. E-post topp- og bunntekstbilder
      2. Tillate bunntekster for enkeltbrukere
      3. Tilpass e-post for signaturforespørsel
      4. Tilpass Til- og Kopi til-feltene
      5. Aktivere koblingsløse varsler
      6. Tilpasse e-postmaler
    23. Flytte fra echosign.com til adobesign.com
    24. Konfigurere alternativer for mottakere
  4. Retningslinjer for lovfestede krav
    1. Tilgjengelighet
      1. Samsvar med tilgjengelighet
      2. Opprette tilgjengelige skjemaer med Acrobat-skrivebordet
      3. Opprett tilgjengelige AcroForms
    2. HIPAA
    3. GDPR
      1. GDPR-oversikt
      2. Skjule en bruker
      3. Skjule en brukers avtaler     
    4. 21 CFR del 11 og EudraLex vedlegg 11
      1. 21 CRF del 11 valideringspakke
      2. Håndbok for vedlegg 11 til 21 CFR og EudraLex
      3. Analyse av felles ansvar
    5. Kunder innen helsesektoren
    6. IVES-støtte
    7. Oppbevaring av avtaler i hvelv
    8. Hensyn for EU/Storbritannia
      1. Grensekryssende EU/UK-transaksjoner og eIDAS
      2. HMLR-krav til dokumenter som er elektronisk signert
      3. Betydningen av Brexit for e-signaturlover i Storbritannia
  5. Last ned flere avtaler samtidig
  6. Kreve domenet ditt 
  7. Koblinger for å rapportere misbruk

Sende, signere og behandle avtaler

  1. Mottakeralternativer
    1. Avbryte en e-postpåminnelse
    2. Alternativer på e-signeringssiden
      1. Oversikt over e-signeringssiden
      2. Åpne for å lese avtalen uten felt
      3. Avslå å signere en avtale
      4. Delegere signeringsautorisasjon
      5. Starte avtalen på nytt
      6. Laste ned avtalen som PDF
      7. Vise avtalehistorikken
      8. Vise avtalebeskjeder
      9. Konvertere fra elektronisk til skriftlig signatur
      10. Konvertere fra skriftlig til elektronisk signatur
      11. Bla gjennom skjemafeltene
      12. Fjerne dataene fra skjemafeltene
      13. Navigere og zoome på signeringssiden
      14. Endre språket som brukes i avtaleverktøyene og informasjonen
      15. Lese de juridiske merknadene
      16. Justere Acrobat Sign-innstillingene for informasjonskapsler
  2. Send avtaler  
    1. Send sideoversikt
    2. Send en avtale kun til deg selv
    3. Send en avtale til andre
    4. Skriftlige signaturer
    5. Signeringsrekkefølge for mottakere
    6. Send samlet
      1. Oversikt over Send samlet-funksjonen
      2. Send samlet – Konfigurer en overordnet mal
      3. Send samlet – Konfigurer CSV-filen
      4. Avbryte en Send samlet-transaksjon
      5. Legg til påminnelser til Send samlet
      6. Rapportering for Send samlet
  3. Redigere felt til dokumenter
    1. Redigeringsmiljø i appen
      1. Automatisk feltgjenkjenning
      2. Dra og slipp felt ved hjelp av redigeringsmiljøet
      3. Tildele skjemafelt til mottakere
      4. Forhåndsutfyll-rollen
      5. Bruke felt med en gjenbrukbar feltmal
      6. Overføre felt til en ny biblioteksmal
      7. Oppdatert forfatterskapsmiljø ved sending av avtaler
    2. Opprette skjemaer og tekstkoder
    3. Opprette skjemaer med Acrobat (AcroForms)
      1. Opprette AcroForm
      2. Opprette tilgjengelige PDF-filer
    4. Felt
      1. Felttyper
        1. Vanlige felttyper
        2. Innebygde bilder
        3. Stempelbilder
      2. Utseende på feltinnhold
      3. Feltvalideringer
      4. Verdier for maskerte felt
      5. Angi vis/skjul betingelser
      6. Beregningsfelt 
    5. Vanlige spørsmål om forfatting
  4. Signer avtaler
    1. Signere avtaler som er sendt til deg
    2. Fyll ut og signer
    3. Selvsignering
  5. Behandle avtaler
    1. Behandle sideoversikt
    2. Delegere avtaler
    3. Erstatte mottakere
    4. Begrense dokumentsynlighet 
    5. Kansellere en avtale 
    6. Opprette nye påminnelser
    7. Gå gjennom påminnelser
    8. Avbryte en påminnelse
    9. Få tilgang til Power Automate-flyter
    10. Flere handlinger ...
      1. Slik fungerer søk
      2. Vise en avtale
      3. Opprette en mal fra en avtale
      4. Skjule/vise avtaler fra visning
      5. Laste opp en signert avtale
      6. Endre filer og felt i en sendt avtale
      7. Redigere godkjenningsmetoden til en mottaker
      8. Legge til eller endre en utløpsdato
      9. Legge til et notat i avtalen
      10. Dele en enkeltavtale
      11. Oppheve deling av en avtale
      12. Laste ned en individuell avtale
      13. Laste ned de individuelle filene i en avtale
      14. Laste ned revisjonsrapporten for en avtale
      15. Laste ned feltinnholdet i en avtale
  6. Revisjonsrapport
  7. Rapportering og dataeksport
    1. Oversikt
    2. Gi brukere tilgang til rapportering
    3. Rapportdiagrammer
      1. Opprette en ny rapport
      2. Avtalerapporter
      3. Transaksjonsrapporter
      4. Innstillinger for aktivitetsrapporter
      5. Redigere en rapport
    4. Dataeksporter 
      1. Opprette en ny dataeksport
      2. Eksport av nettskjemadata
      3. Redigere en dataeksport
      4. Oppdatere dataeksportinnholdet
      5. Laste ned dataeksporten
    5. Gi nytt navn til et diagram / en eksport
    6. Duplisere en rapport/eksport
    7. Planlegge en rapport/eksport
    8. Slette en rapport/eksport
    9. Kontrollere transaksjonsbruk

Avanserte avtalefunksjoner og arbeidsflyter

  1. Nettskjemaer 
    1. Opprette et webskjema
    2. Redigere et webskjema
    3. Aktivere/deaktivere et webskjema
    4. Skjule/vise et webskjema
    5. Finne nettadressen eller skriptkoden 
    6. Forhåndsutfylle nettskjemafelt med nettparametere
    7. Lagre et webskjema for å fullføre senere
    8. Velge et nettskjema
  2. Gjenbrukbare maler (Bibliotekmaler) 
    1. Amerikanske offentlige skjemaer i Acrobat Sign-biblioteket
    2. Opprette en biblioteksmal
    3. Endre navnet på en bibliotekmal
    4. Endre type for en bibliotekmal
    5. Endre tillatelsesnivået for en biblioteksmal
    6. Kopiere, redigere og lagre en delt mal
    7. Laste ned de samlede feltdataene for en biblioteksmal
  3. Overføre eierskap til nettskjemaer og bibliotekmaler
  4. Power Automate-arbeidsflyter 
    1. Oversikt over Power Automate-integreringen og inkluderte rettigheter
    2. Aktivere Power Automate-integreringen
    3. Konteksthandlinger på Administrer-siden
    4. Sporing av Power Automate-bruk
    5. Opprette en ny flyt (eksempler)
    6. Utløsere som brukes for flyter
    7. Importere flyter fra utenfor Acrobat Sign
    8. Administrer flyter
    9. Rediger flyter
    10. Dele flyter
    11. Deaktivere eller aktivere flyter
    12. Slette flyter
    13. Nyttige maler
      1. Kun administrator
        1. Lagre alle fullførte dokumenter i SharePoint
        2. Lagre alle fullførte dokumenter på OneDrive for Business
        3. Lagre alle fullførte dokumenter på Google Disk
        4. Lagre alle fullførte dokumenter i DropBox
        5. Lagre alle fullførte dokumenter i Box
      2. Avtalearkiver
        1. Lagre de fullførte dokumentene i SharePoint
        2. Lagre de fullførte dokumentene i One Drive for Business
        3. Lagre de fullførte dokumentene på Google Disk
        4. Lagre dine fullførte dokumenter i DropBox
        5. Lagre de fullførte dokumentene i Box
      3. Arkivering av nettskjemaavtale
        1. Lagre fullførte nettskjemadokumenter i SharePoint-biblioteket
        2. Lagre fullførte nettskjemadokumenter i OneDrive for Business
        3. Lagre fullførte dokumenter på Google Disk
        4. Lagre fullførte nettskjemadokumenter i Box
      4. Avtaledatauttrekking
        1. Trekke ut skjemafeltdata fra det signerte dokumentet og oppdatere Excel-ark
      5. Avtalevarsler
        1. Sende tilpassede e-postvarsler med avtaleinnholdet og signert avtale
        2. Få Adobe Acrobat Sign-varsler i en Teams-kanal
        3. Få Adobe Acrobat Sign-varsler i Slack
        4. Få Adobe Acrobat Sign-varsler i Webex
      6. Generering av avtaler
        1. Generere dokument fra Power App-skjema og Word-mal, sende til signering
        2. Generere avtale fra Word-mal i OneDrive, og få signatur
        3. Generere avtale for valgt Excel-rad, sende til gjennomgang og signering
  5. Tilpassede arbeidsflyter for sending
    1. Oversikt for tilpasset Send-arbeidsfly
    2. Opprette en ny Send-arbeidsflyt
    3. Redigere en Send-arbeidsflyt
    4. Aktivere eller deaktivere en tilpasset Send-arbeidsflyt
    5. Sende en avtale med en Send-arbeidsflyt
  6. Dele brukere og avtaler
    1. Dele en bruker
    2. Dele avtaler

Integrere med andre produkter

  1.  Oversikt over Acrobat Sign-integrasjoner 
  2. Acrobat Sign for Salesforce
  3. Acrobat Sign for Microsoft
    1. Acrobat Sign for Microsoft 365
    2. Acrobat Sign for Outlook
    3. Acrobat Sign for Word/PowerPoint
    4. Acrobat Sign for Teams
    5. Acrobat Sign for Microsoft PowerApps og Power Automate
    6. Acrobat Sign Connector for Microsoft Search
    7. Acrobat Sign for Microsoft Dynamics
    8. Acrobat Sign for Microsoft SharePoint
  4. Andre integrasjoner
    1. Acrobat Sign for ServiceNow
    2. Acrobat Sign for HR ServiceNow
    3. Acrobat Sign for SAP SuccessFactors
    4. Acrobat Sign for Workday
    5. Acrobat Sign for NetSuite
    6. Acrobat Sign for VeevaVault
    7. Acrobat Sign for Coupa BSM Suite
  5. Partneradministrerte integrasjoner
  6. Hvordan innhente en integrasjonsnøkkel

Acrobat Sign-utvikler

  1. REST-API-er 
    1. Metodedokumentasjon
    2. SDK/utviklerveiledning
    3. Vanlige spørsmål om API
  2. Webhook 
    1. Oversikt over webhook
    2. Konfigurere en ny webhook
    3. Vise eller redigere en webhook
    4. Deaktivere eller reaktivere en webhook
    5. Slette en webhook
    6. Toveis SSL-sertifikater
    7. Webhooks i API-et

Kundestøtte og feilsøking

  1. Ressurser for kundestøtte 
  2. Suksessressurser for Enterprise-kunder 

API-tilgang er reservert eksklusivt for Enterprise- og Developer-kontoer.

Lenker til kjernedokumentasjon

Merk:

Støtte for de eldre SOAP API-ene ble avsluttet fra mai 2021.

Alle kunder som bruker SOAP API, bør gå over til REST API så snart som mulig.

Når du er logget på, går du til Konto > API for Acrobat Sign > API-informasjon > Rest API-er og dokumentasjon.


Generelle begreper

Du kan ikke redigere dokumentet ved å vise siden i webgrensesnittet eller med dra og slipp, eller tilordne signaturroller ved hjelp av transientDocumentId via API.

TransientDocuments-kallet returnerer transientDocumentID, som er gyldig i 7 dager.  Du kan bare bruke den til videre API-kall. Den lagres på API-serveren og tildeles denne ID-en. Last opp en fil og referer deretter til ID-en i de videre API-kallene.

Du kan ikke laste opp et dokument direkte i avtalen ved hjelp av REST API.

I henhold til REST-kravet må du først opprette et transient dokument og deretter bruke denne ID-en i avtale-, widget- eller bibliotekmetoder som filkilde.

Det transiente dokumentet er en rå kildefil som PDF, doc eller docx, lastet opp til Adobe-serverne. Så det er en praktisk måte å overføre basedokumentet til API-serverne og et transient dokument på nettet på.

Ja, du kan legge ut avtaler ved hjelp av arbeidsflyter i v6 med API-kallet POST /agreements. Send workflowId-parameteren i API-kallet.

Du kan få workflowId for en arbeidsflyt med kallet GET /workflows.

  1. Logg på Adobe Sign som administrator

  2. Gå til Konto > API for Adobe Sign > API-forespørselslogg

    API-logger

  1.  Logg på Adobe Sign som administrator

  2. Gå til: Konto > API for Adobe Sign > API-informasjon

  3. Klikk på lenken REST API Samples.

    Merk:

    For å laste ned JavaScript SDK se https://github.com/adobe-sign/AdobeSignJsSdk.

Fra og med v6 er ikke alternativet "sendTroughWeb" lenger tilgjengelig. State erstatter det. Det er statusen avtalen lander i. Statusfeltet kan bare brukes i POST-kall. Det blir aldri returnert i GET /agreements/{ID} og ignoreres hvis det er gitt i PUT /agreements/{ID}-kall. Eventuell status for avtalen kan fås fra GET /agreements/ID.

stat(streng) = ['AUTHORING' eller 'DRAFT' eller 'IN_PROCESS'].

AUTHORING tillater en bruker å forfatte dokumentene til en avtale før de sendes ut. Forfatteroperasjonen her refererer til å opprette, redigere eller plassere skjemafelt sammen med konfigurasjonene (tildelt til, betingelser, datatype og så videre.) i avtaledokumentene. Etter at dokumentet er lagt ut med statusen Authoring, er dokumentet synlig under Utkast på Behandle-fanen i Adobe Sign.

DRAFT er midlertidig eller en primitiv fase av den endelige tiltenkte ressursen som kan oppdateres trinnvis for å opprette den endelige ressursen, og er ikke synlig under Utkast på Behandle-fanen i Adobe Sign. Ved bruk av Draft-status er ikke deltakersettinformasjon nødvendig, og det kan senere tildeles mens du utfører PUT /agreements/agreementId for å fullføre dette utkastet. Dette trinnet kan gjentas flere ganger til du har alle nødvendige data for å opprette avtalen.

IN_PROCESS endrer avtalestatusen til Out for Signature (Ute til signatur) og vises under Ute til signatur på Behandle-fanen i Adobe Sign.

SendThroughWeb lar deg sende avtalen interaktivt. De forskjellige parameterne i "opsjoner"-feltet i v5 POST /agreements tillater brukeren å konfigurere denne interaktive visningen (Send side). Alle disse sidekonfigurasjonsparameterne, som fileUploadOptions, er flyttet til API-et POST agreements/ID/views.

Så du kan faktisk oppnå sendThroughWeb ved å opprette en avtale i AUTHORING-status gjennom API-et POST /agreements. Kall deretter API-et POST agreements/ID/views for å be om URL-adressen til neste side i ønsket konfigurasjon.

Følg denne fremgangsmåten:

1. Gå til REST API V6-dokumentasjon og velg metoden POST /agreements.
2. Bruk følgende forespørselskode:

{

  "fileInfos": [

    {

      "transientDocumentId": "***************************"

    }

  ],

  "name": "test",

  "participantSetsInfo": [

    {

      "memberInfos": [

        {

          "email": "abc@gmail.com"

        }

      ],

      "order": 1,

      "role": "SIGNER"

    }

  ],

  "signatureType": "ESIGN",

  "state": "AUTHORING"

}

 

3. Bruk nå metoden post /agreements/{agreementId}/views sammen med forespørselskoden nedenfor:

 

{

  "name": "AUTHORING"

}

Svarkoden gir URL-adressen til forfatterfelt.

Man kan definere tilbakekall-URL på følgende måter:

  • Bruk parameteren nedenfor til å definere tilbakekall-URL etter behov:

    "callbackInfo": "",
  • Kontakt Adobe Sign-støtte for å angi standard tilbakekall-URL for full konto.

SOAP UI (SmartBear) får SSL-tilkoblingsfeil som ligner på den følgende, som du får når du foretar API-kall. Denne feilen oppstår vanligvis hvis du bruker utdaterte SSL- eller TLS-protokoller som er lavere enn TLS1.2

FEIL: Unntak i forespørsel: javax.net.ssl.SSLException: Mottok alvorlig feil: protocol_version
FEIL: En feil oppsto [Received fatal alert: protocol_version], se feilloggen for detaljer

  1. Legg til (-Dsoapui.https.protocols=SSLv3,TLSv1.2) i VMOPTIONS-filen under Bin-mappen.

  2. Gå til C:\Programfiler\SmartBear\SoapUI-5.2.1\bin (Avhengig av hvor du har installert SOAP UI. Det kan være under C:\Programfiler (x86))

  3. I VMOPTIONS-filen aktiverer du full lese-/skrivetillatelse.

    VMOPTIONS

  4. Høyreklikk på VMOPTIONS-filen> Egenskaper>Sikkerhet-fanen> Velg bruker> Klikk på Rediger. (Ikonet for brukertilgangskontroll vises på Rediger-knappen)> Merk av i alle avmerkingsboksene og klikk på OK.

  5. Gjenta det samme for administratorer, systemer og alle programpakker.

  6. Åpne filen i Notisblokk.

  7. Legg til denne protokollen nederst "-Dsoapui.https.protocols = SSLv3, TLSv1.2" og lagre endringene.

  8. Lukk SOAP UI og start på nytt. Det fungerer uten SSL-feil når du foretar API-kall. (Utfør test-pingkall for å sjekke).

Det følgende er fremgangsmåten for å opprette klient-ID og klienthemmelighet i Adobe Sign-programmet:

  1. Logg på Adobe Sign-kontoen.

  2. Gå til Konto > API for Adobe Sign > API-programmer.

    Fnord.

  3. Klikk på +-ikonet for å opprette et program.

    Fnord.

  4. Skriv inn navn og visningsnavn.

  5. Velg KUNDE under Domene og klikk på Lagre.

    Fnord.

  6. Merk programmet ved å klikke på det.

  7. Klikk på Konfigurer OAuth for programmet.

    Fnord.

  8. Angi URI for omdirigering.

  9. For å aktivere de nødvendige omfangene merker du av i de respektive avmerkingsboksene og klikker på Lagre.

  1. Logg på Adobe Sign som kontoadministrator

  2. Gå til: Konto > API for Adobe Sign > API-informasjon

  3. Klikk på lenken Integreringsnøkkel

    Naviger til integreringsnøkkel

    Merk:

    Hvis du ikke ser lenken til integreringsnøkkel, kan du kontakte den kundeansvarlige for å få aktivert kontoen din.

    • Gi nøkkelen et navn med en intuitiv verdi
    • Velg de forskjellige omfangene som kreves for programfunksjonen din
    • Klikk på Lagre når nøkkelen er fullt konfigurert
    Grensesnittet Opprett integreringsnøkkel

  4. Når du har lagret den, finner du nøkkelen i: Konto > Personlige innstillinger > Tilgangstokener

    Navnet på nøkkelen og alle aktiverte omfang vises.  

    Klikk på nøkkelbeskrivelsen én gang for å vise handlingslenkene:

    • Integreringsnøkkel – Denne lenken gir nøkkelen
    • Opphev– Dette opphever og sletter tilgangstokenet permanent
    Tilgangstokener – Integreringsnøkkel

  1. Logg på Adobe Sign-kontoen.

  2. Gå til Konto > API for Adobe Sign > API-programmer.

  3. Klikk på +-ikonet for å opprette et program.

    Postman1

  4. Klikk på Konfigurer OAuth for programmet.

    Fnord.

  5. Generer godkjenningskode ved hjelp av følgende lenke. Klient-ID, URI for omdirigering og omfang må være de samme som i følgende URL som valgt i programmet (unngå mellomrom i followingURL og Shard som 'NA1' i henhold til tilhørende Adobe Sign-konto):

    https://secure.na1.echosign.com/public/oauth?redirect_uri=https://www.google.co.in&response_type=code&client_id=CBJCHBCAABAAo9FZgq31_5BVG_kcIXEe6gNtn-R-gdNe&scope=user_login:self+agreement_send:account

  6. Hvis kallet er vellykket, velger du godkjenningskode fra adresselinjen.

    Fnord.

  7. Last ned og installer Postman fra lenken https://www.getpostman.com/apps.

  8. Når den er lastet ned og installert, klikker du på NEW for å opprette en POST.

  9. Skriv inn lenken https://secure.na1.echosign.com/oauth/token i henhold til din Adobe Sign-konto.

  10. Oppgi Content-Type som application/x-www-form-urlencoded under Headers.

  11. Forsikre deg om at x-www-form-urlencoded er valgt under Body og skriv inn parameterne nedenfor med tilhørende verdier fra programmet opprettet i Adobe Sign-kontoen, og klikk på SEND.

    Fnord.

  12. Hvis all informasjonen er riktig, returneres tilgangstokenet og oppdateringstokenet i svaret:

    Fnord.

Når du kjører OAuth Process, må du følge disse punktene:

1. Riktig klient-ID og URI for omdirigering er spesifisert.
2. Omfang gitt i godkjennings-URL må samsvare nøyaktig med omfanget som er gitt i Adobe Sign-programmet.
3. Bruk riktig shard (na1, na2, au1, eu1, jp1) i henhold til kontoen som konfigureres.
4. Fjern eventuelle mellomrom i godkjennings-URL-en (hvis noen).
5. Sjekk syntaksen for godkjennings-URL-en:

https://secure.na1.echosign.com/public/oauth?redirect_uri=https://secure.na1.echosign.com/public/oauthDemo&
response_type=code&client_id=9MEJXY4Y4R7L2T&scope=agreement_send

Tilgangstokener er bare gyldige i 3600 sekunder (én time) før de utløper.

API-forespørselinnehaveren kan bruke Oppdater tokens for å generere nye tilgangstokener etter behov.

Webhooks støttes i REST API v6 og nyere.

Hvis en Webhook-mottaker ikke svarer innen 72 timer, blir webhooken deaktivert, og ingen varsler blir sendt.

Hvis mål-URL-en for webhooken er nede av en eller annen grunn, setter Adobe Sign JSON i kø og prøver på nytt i en progressiv syklus over 72 timer.

De ikke-leverte hendelsene blir værende i en prøv på nytt-kø, og det gjøres en best mulig innsats i løpet av de neste 72 timene for å levere varslene i den rekkefølgen de oppsto.

Strategien for å prøve å levere varsler på nytt er en dobling av tiden mellom forsøk, og starter med et ett minutts intervall som øker til hver 12. time, og resulterer i 15 nye forsøk i løpet av 72 timer.

 

For å opprette webhook direkte fra Adobe Sign-brukergrensesnittet må du først opprette webhook-URL gjennom Azure AD-funksjonsapper ved å bruke fremgangsmåten nedenfor:

  1. Logg på via Microsoft-konto https://portal.azure.com/.

  2. Registrer deg for funksjonsapper under AzureAD-kontoen.

    Azure-meny

  3. Gå til AzureAD og gå til Function Apps > Klikk på +-ikonet for Functions.

  4. Velg Webhook+API med Javascript som språk, og klikk på Create Function.

    Azure API-brukergrensesnitt

  5. Erstatt Index.js-filen med følgende kodesnutt:

    module.exports = function (context, req) { 
        var clientId = req.headers['x-adobesign-clientid']; 
        // Validate that the incoming ClientID is genuine 
        if (clientId === '************************************') { 
            context.res = { 
                // status: 200, /* Defaults to 200 */ // any 2XX response is acceptable 
                body: { 
                    'xAdobeSignClientId' : clientId, 
                     
                }, 
                headers : { 
                    'Content-Type' : 'application/json' 
                } 
            }; 
        } 
        else { 
            context.res = { 
                status: 400, 
                body: "Opps!! Illegitimate Call identified" 
            }; 
        } 
        context.done(); 
    };
  6. Klikk på Test-knappen i høyre hjørne og oppgi følgende overskrift:

    X-AdobeSign-ClientId as ***********************

    API-test

  7. Klikk på Save and Run.

  8. Når du mottar 200 OK-svar med følgende overskrift, klikker du på Get function URL

    200 svar

  9. Kopier URL-en, og gå til Adobe Sign UI > Webhooks > Klikk på +-ikonet for å opprette.

  10. Skriv inn følgende informasjon:

    • Name: Det foreslås et intuitivt navn som andre administratorer lett kan forstå.
    • Scope: Hvor bredt nett skal webhooken fange. Konto og gruppe er tilgjengelig i grensesnittet.
      API-et støtter omfangene Konto, Gruppe, Bruker og Ressurs.
    • Bare ett omfang per webhook kan defineres
    • URL: Mål-URL som Adobe Sign sendte JSON-nyttelasten til.
    • Events: Utløseren som får Adobe Sign til å bygge JSON og sende til URL-en.
      Hver hendelse bygger en annen nyttelast som er relevant for utløserhendelsen
      Flere hendelser kan inkluderes i en webhook.
    • Notification Parameters: Varslingsparameterne identifiserer delene av Event JSON-nyttelasten, slik at du kan velge de delene av hendelsen som er viktige.
    Webhook UI

  11. Når webhooken er fullt definert, klikker du på Save, og den nye webhooken begynner å reagere for å utløse hendelser umiddelbart.

Avtaleressursen refererer til en ressurs der du kan opprette en avtale, for eksempel bibliotekdokument, widget og avtale.

For å søke etter avtaleressurshendelser må du først sende en forespørsel til API-et som oppretter agreementAssetEvents med relevante søkeparametere.

Svaret er den første siden med resultater sammen med en søke-ID-parameter og markøren for neste side. Du kan bruke den til å hente ytterligere sideresultater ved hjelp av API-et, som henter agreementAssetEvents basert på søke-ID.

  1. Åpne REST API-dokumentasjonen for versjon 5.

  2. Gå til post/search/agreementAssetEvents og generer tilgangstokenet med relevante omfang.

  3. I forespørselskoden definerer du start- og sluttdato i henhold til kravet:

    { 
      "endDate": "2018-05-22T22:33:33", 
      "startDate": "2017-12-22T22:33:33" 
    }
  4. Klikk på Try it out. Den henter avtaleressurs-ID-er, som også kan brukes som avtale-ID-er.


Bruker-/kontoadministrasjon

  1. Logg på Adobe Sign.
  2. Gå til Konto > API for Adobe Sign > REST API-dokumentasjon.
  3. Velg versjon 5.
  4. Under metoden post /users bruker du forespørselskoden nevnt under
    UserCreationInfo-metoden
    {
    "email": "email@email.com",
    "firstName": "AA",
    "lastName": "AB",
    "password": "12******rte"
    }

Adobe Sign-kontoer som bruker Admin Console (Adobe One) til å administrere brukerrettigheter, kan ikke bruke Adobe Sign-API til å opprette brukere eller administrere eksisterende brukere.

Adobe One Admin Console bruker et annet API enn Adobe Sign-API. Se disse artiklene for mer informasjon:

 

Hente gruppe-ID:

  1. Gå til https://secure.na1.echosign.com/public/docs/restapi/v5.

  2. Klikk på grupper under Resources and Operations.

  3. Klikk på GET /groups.

  4. Klikk på knappen oAuth Access-token.

  5. Generer tilgangstokenet.

  6. Klikk på knappen Try it out.

    Du mottar et svar som dette, med gruppenavn og gruppe-ID:

    { 
      "groupInfoList": [ 
        { 
          "groupId": "3AAABLblqZhB4o9EnlvmGB_m8CrG5O6XClTBO7vmojOOexu5r3G95LtEV2Sp7BuhNvQYSvWB7PmmwVPXnhPIiYSuHV98Cerkp", 
          "groupName": "Default Group" 
        }, 
        { 
          "groupId": "3AAABLblqZhC3dPT6za5h7r1-BOEWivCe_OcAVONhcsKa57SL9_iCwGr5v_JED1No5jE20Pcjv0mYH2J-LoY1AcmqS69vRkO7", 
          "groupName": "test" 
        }, 
      ] 
    }

Slette gruppe:

  1. Klikk på DELETE /groups/{groupId}.

  2. Klikk på knappen oAuth Access-token for å generere tilgangstoken.

  3. Legg til groupId mottatt i svaret på forrige kall, som du vil slette, i groupId Box.

  4. Klikk på Try it out.

    Du får svar som det følgende når gruppen er slettet: No content

Merk:

Du kan ikke slette en gruppe som har en tildelt bruker. Du kan hovedsakelig bare slette den tomme gruppen. Du får svar som det følgende hvis det er en bruker i gruppen.


{

  "code": "GROUP_NOT_EMPTY",

  "message": "The group cannot be deleted because it is not empty."

}


Starte/sende avtaler

Generere et transient dokument

  1. Klikk på transientDocuments og utvid metoden POST /transientDocuments

  2. Klikk på knappen OAuth Access-token

    API TransientDocument Method

    • Aktiver omfangene for transaksjonen
    • Klikk på Authorize (Godkjenn)
    OAuth-omfang

  3. Gi tilgang

    Hvis du blir utfordret, klikker du på Allow Access (Gi tilgang)

  4. Du kommer tilbake til API-metodesiden. Godkjenningsverdien er nå fylt ut.

    • Skriv inn filnavnet i feltet File-Name
    • Klikk på Choose File-knappen og last opp dokumentet for avtalen
    • Klikk på knappen Prøv det! Start
    Try it out!

  5. Svaret genereres.

    transientDocumentID finner du i Response Body:

    Transient dokument-ID

Generere en avtale ved hjelp av transientdokumentet

  1. Klikk på agreements og utvid metoden POST /agreements

    • Klikk på knappen OAuth Access-token
    • Aktiver OAuth-omfanget
    • Klikk på Authorize (Godkjenn)
      • Hvis du blir utfordret, klikker du på Allow Access (Gi tilgang)
  2. Du kommer tilbake til API-metodesiden. Godkjenningsverdien er nå fylt ut.

    • Kopier skriptet nedenfor til et tekstredigeringsprogram (dette skriptet er bare et minimalt konfigurert eksempel; produksjonskoden din vil være annerledes)
    •  Sett inn trasientDocumentId-verdien i koden der det er angitt
    { 
      "fileInfos": [ 
       {"transientDocumentId":"PASTE YOUR TRANSIENTDOCUMENTID HERE"} 
      ], 
      "name": "test doc", 
      "participantSetsInfo": [ 
        { 
          "memberInfos": [ 
            { 
              "email": "noreply@echosign.com" 
            } 
          ], 
          "order": 1, 
          "role": "SIGNER" 
        } 
      ], 
      "signatureType": "ESIGN", 
      "state": "DRAFT" 
    }

     

    • Kopier det tilpassede skriptet og lim det inn i feltet AgreementInfo
    • Klikk på knappen Prøv det! Start
    POST agreement-metode

  3. Svaret genereres.

    AgreementID finner du i Response Body:

    POST agreement-metodesvar

Det følgende er trinnene for å legge til filer i FileInfo Parameter:

  1. Bruk transient ID:

    Gå til POST/transientDocuments og last opp dokumentet som skal brukes, fra ditt lokale system.
    Bruk transient-ID-en generert under Filinfo-delen i POST /Agreements:

    "fileInfos": [ 
         { 
           "transientDocumentId": "" 
         } 
       ],
  2. Bruk bibliotekdokument-ID:

    Gå til Dashboard. Klikk på Legg til dokument i bibliotek og lagre malen.
    Under REST API-dokumentasjon klikker du på GET /libraryDocuments og henter biblioteks-ID for malen som opprettes.
    Oppgi bibliotekdokument-ID-en under POST /Agreements:

    "libraryDocumentId": "", 
      "libraryDocumentName": "",
  3. Bruk offentlig tilgjengelig URL:

    Oppgi den offentlig tilgjengelige URL-en som skal brukes under FileInfo-parameteren:

    { 
          "documentURL": { 
            "mimeType": "", 
            "name": "", 
            "url": "" 
          },
  1. Velg alternativet Agreements> POST/agreements. 

  2. Velg alternativet Oauth Access-Token, og oppgi nødvendige omfang.

  3. Når tilgangstokenet er lagt til, kan du bruke følgende forespørselskode:

    { 
    "documentCreationInfo": { 
         "recipientSetInfos": [ 
              { 
                   "recipientSetRole": "SIGNER", 
                   "recipientSetMemberInfos": [{"email": "testemail@email.com"}] 
              }, 
              { 
                   "recipientSetRole": "SIGNER", 
                   "recipientSetMemberInfos": [{"email": "testemail@email.com"}] 
              } 
         ], 
         "signatureFlow": "SEQUENTIAL", 
         "name": "husband wife", 
         "signatureType": "ESIGN", 
         "fileInfos": [ 
    { 
    "transientDocumentId": "(SAMPLE VALUE)3AAABLblqZhAJ9H6e23kZAfBUbItPvIhHTEyA6eZhziEp4KSntYcULpo43OEXwuWiWa-IM1r1EExYW0044CjCkliP4WFL5yKBUDq5DYSmSxVlFypcD0at8kK-BX-Mu3T9c_3GUqgDg0ArX0MmzWT72GLR_0M4Jq--mtuqGzq-VK1s-WGR6GcbedVY7XWAf3b3h-SpE08Hc-iF3zO7jQzi9newXSl-iW2JJsb_55tggkyxkXAkj74C1WD6KkJzgblK0JU-seh6QPDd0Fv6_mfQe2EPQA31nXj50aXwD_xlUBq7mg5FeaBnZ5bzgoqIWGHkbyeD2taaFdw*"} 
    ] 
    } 
    }

I POST /agreements-kall, for signatureflow-parameteren kan du sende verdien SENDER_SIGNS_FIRST eller SENDER_SIGNS_LAST verdien for å legge til avsenderen som henholdsvis første eller siste underskriver.

Her er et eksempel på kallet i JSON-format:

{

  "documentCreationInfo": {

    "fileInfos": [

      {        "transientDocumentId":"3AAABLblqZ-yourIDGoesHere"

      }

    ],

    "name": "Test",

    "recipientSetInfos": [

      {

        "recipientSetMemberInfos": [

          {

            "email": "test@email.com"

          }

        ],

        "recipientSetRole": "SIGNER"

      }

    ],

    "signatureType": "ESIGN",

    "signatureFlow": "SENDER_SIGNS_FIRST"

  }

}

Merk:

Alternativet for sending på vegne er bare tilgjengelig i REST API V6 med avansert deling på.

Hvis Send-tillatelse ikke er gitt ved deling eller hvis Avansert deling ikke er aktivert, får du et svar som dette:

 

{"code":"PERMISSION_DENIED","message":"User provided in x-on-behalf-of-user header does not have required permission to perform this operation."}

 

For funksjonen Send på vegne aktiverer du Avansert kontodeling for kontoen, slik at brukere kan gi sendetillatelser til andre brukere mens de deler kontoen sin. For avansert deling se Aktivering av avansert kontodeling.

Når brukerdeling er aktivert, går du gjennom følgende trinn for å sende på vegne av:

Generere et transient dokument:

  1. Klikk på POST /transientDocuments under transientDocuments.

  2. For å generere token for godkjenning klikker du på knappen OAUTH ACCESS-TOKEN.

  3. I x-on-behalf-of-user oppgir du e-postadressen til brukeren du vil sende på vegne av i følgende format: email: test@email.com

  4. Klikk på Choose File for å velge en fil, og klikkpå Try it out.

    Du får et svar som dette med transientDocumentId:

    {"transientDocumentId":"3AAABLblqZhB9Mjo0mrIu_pSgrf5VsMaKM68_Vmn80cimaqiUAD2OxrPp2e5H8GvjfiOxj4d5B8bCPkUfvaozW3KLisp_wseGVOL8A7oNZni1DWyFi4uNoxLQu4nUO44Wh63GQv9_HEJMePust0Pk94vJ_rbS96R7ic-vl7jbOkN0b4EB5-JMqlC-Fl_Vpyz8I1EQUrM5I4nB9ztMov4ad00yiOtDw0tB-Y2t5JdzM07P-mpJmwYEl8Fq2IeDuWjcR2tV7qY7TNGX2CNyh9jt0aMyduHeYa0GABr69z8Hm76eKdtaM_1E1ggWj205fSrNcwJsnpSO278*"}

Generere en avtale ved hjelp av Transient-dokumentet:

  1. Klikk på POST /agreements under agreements.

  2. For å generere token for godkjenning klikker du på knappen OAUTH ACCESS-TOKEN.

  3. I x-on-behalf-of-user oppgir du brukerens e-postadresse som da Transient-dokumentet ble opprettet.

  4. I AgreementInfo legger du til følgende kode og klikker på Try it out.

    { 
      "fileInfos": [ 
        {    "transientDocumentId":"3AAABLblqZhB9Mjo0mrIu_pSgrf5VsMaKM68_Vmn80cimaqiUAD2OxrPp2e5H8GvjfiOxj4d5B8bCPkUfvaozW3KLisp_wseGVOL8A7oNZni1DWyFi4uNoxLQu4nUO44Wh63GQv9_HEJMePust0Pk94vJ_rbS96R7ic-vl7jbOkN0b4EB5-JMqlC-Fl_Vpyz8I1EQUrM5I4nB9ztMov4ad00yiOtDw0tB-Y2t5JdzM07P-mpJmwYEl8Fq2IeDuWjcR2tV7qY7TNGX2CNyh9jt0aMyduHeYa0GABr69z8Hm76eKdtaM_1E1ggWj205fSrNcwJsnpSO278*" 
        } 
      ], 
      "name": "Test", 
      "participantSetsInfo": [ 
        { 
          "memberInfos": [ 
            { 
              "email": "signer@email.com" 
            } 
          ], 
          "order": 1, 
          "role": "SIGNER" 
        } 
      ], 
      "signatureType": "ESIGN", 
      "state": "IN_PROCESS" 
    }

     

    Du får et svar som dette med agreementID:

    { 
      
      "id": "CBJCHBCAABAAUlen3l_fzlj1Kbn_wGZAhYcIgN0J7Qtq" 
      
    }
  1. Logg deg på Adobe Sign.

  2. Gå til Konto> Adobe Sign API> API-informasjon og klikk på REST API Method Documentation.

    Webhook UI

  3. POST / transientDocuments og last opp en fil og opprett en transient Document ID.

  4. Kopier transient Document ID og bruk den i POST /agreements-metoden. Nevn følgende JSON-forespørsel i boksen:

    { 
        "documentCreationInfo": { 
            "mergeFieldInfo": null, 
            "recipientSetInfos": [{ 
                    "signingOrder": null, 
                    "recipientSetRole": "SIGNER", 
                    "recipientSetMemberInfos": [{ 
                        "securityOptions": null, 
                        "email": "test1@gmail.com" 
                    }], 
                    "privateMessage": "Hello 1", 
                    "securityOptions": null 
                }, 
                { 
                    "signingOrder": null, 
                    "recipientSetRole": "SIGNER", 
                    "recipientSetMemberInfos": [{ 
                        "securityOptions": null, 
                        "email": "test2@gmail.com" 
                    }], 
                    "privateMessage": "Hello 2", 
                    "securityOptions": null 
                } 
            ], 
            "signatureType": "ESIGN", 
            "callbackInfo": null, 
            "message": "Please review and sign this document.", 
            "locale": "en_US", 
            "vaultingInfo": null, 
            "securityOptions": null, 
            "reminderFrequency": null, 
            "ccs": null, 
            "postSignOptions": null, 
            "signatureFlow": "SENDER_SIGNATURE_NOT_REQUIRED", 
            "daysUntilSigningDeadline": null, 
            "formFieldLayerTemplates": [], 
            "name": "Adobe Sign Agreement", 
            "formFields": null, 
            "fileInfos": [{ 
                "libraryDocumentName": null, 
                "transientDocumentId": "XXXXXXXXXXXX", 
                "documentURL": null, 
                "libraryDocumentId": null 
            }] 
        } 
    }
  5. For å utføre JSON-forespørselen klikker du på knappen Try it out.

    Webhook UI

    Riktig JSON returnerer svaret med avtale-IDen.

    Webhook UI

Det følgende er parameterne du kan gi i koden for å angi passord for åpning:

 

{

    "documentCreationInfo":

    [{

        "signatureType": "ESIGN",

               "recipientSetInfos": [{

            "recipientSetMemberInfos": [{

                "email": "abc@xyz.com"

            }],

                   

            "recipientSetRole": "SIGNER"

        }],

               "signatureFlow": "SENDER_SIGNATURE_NOT_REQUIRED",

                   "fileInfos": [           {

            "libraryDocumentId": "3AAABLblqZhBsm_vH7TVzU3hRdbtWuvzfTKDvBzaKZTiehjO2eGTk5Rlu02K-0BYn8HBJVFTWOmT_BQlrofPBlrCdjiJ_JI-V"

        }       ],

               "name": "Open password to view document",

               "securityOptions": {

            "openPassword": "1234",

                     "protectOpen": true

        }

    }]

}

 

Gjør følgende for å opprette en avtale ved hjelp av API med statusen "AUTHORING":

Gå til Post /agreements og opprett tilgangstoken med de nødvendige omfangene.

Bruk følgende forespørselskode:

 

{

  "fileInfos": [

    {

      "transientDocumentId": "*********************"

    }

  ],

  "name": "A1",

  "participantSetsInfo": [

    {

      "memberInfos": [

        {

          "email": "abc@xyz.com"

        }

      ],

      "order": 1,

      "role": "SIGNER"

    }

  ],

  "signatureType": "ESIGN",

  "state": "AUTHORING"

}

 

V6 har et sett med authoring-API-er for oppretting av avtale. I v5 konsumeres formFields direkte i API-et POST /agreements. I v6 kan imidlertid brukeren opprette en avtale i AUTHORING-status (state = AUTHORING) gjennom v6 POST /agreements og bruke PUT /agreements/ID/formFields senere for å legge til skjemafelt i dokumentene til denne avtalen.

Dette er trinnene:

  1. Gå til REST API V6-dokumentasjonen og velg POST /agreements-metoden.

  2. Bruk følgende forespørselskode:

    { 
      "fileInfos": [ 
        { 
          "transientDocumentId": "***************************" 
        } 
      ], 
      "name": "test", 
      "participantSetsInfo": [ 
        { 
          "memberInfos": [ 
            { 
              "email": "abc@gmail.com" 
            } 
          ], 
          "order": 1, 
          "role": "SIGNER" 
        } 
      ], 
      "signatureType": "ESIGN", 
      "state": "AUTHORING" 
    }
  3. Bruk metoden put /agreements/{agreementId}/formFields med følgende forespørsel som eksempel:

    { 
      "fields": [ 
        { 
         "locations": [ 
              { 
                "height": 36, 
                "left": 75, 
                "pageNumber": "1", 
                "top": 200, 
                "width": 150 
              } 
            ], 
            "contentType": "SIGNATURE_BLOCK", 
            "name": "sigBlock1", 
            "inputType": "SIGNATURE", 
            "recipientIndex":1 
           } 
    ]}

     

    Den sender avtalen til nevnte mottaker når forespørselen er fullført.

  1. Logg deg på Adobe Sign.

  2. Gå til Konto> Adobe Sign API> API-informasjon og klikk på REST API Method Documentation.

    Webhook UI

  3. POST / transientDocuments og last opp en fil og opprett en transient Document ID.

  4. Kopier transient Document ID og bruk den i POST /agreements-metoden. Nevn følgende JSON-forespørsel i boksen:

    { 
        "documentCreationInfo": { 
            "recipientSetInfos": [{ 
                    "recipientSetRole": "SIGNER", 
                    "recipientSetMemberInfos": [{ 
                        "email": "test1@gmail.com" 
                    }], 
                    "privateMessage": "Hello 1" 
                }, 
                { 
                    "recipientSetRole": "SIGNER", 
                    "recipientSetMemberInfos": [{ 
                        "email": "test2@gmail.com" 
                    }], 
                    "privateMessage": "Hello 2" 
                } 
            ], 
            "signatureType": "ESIGN", 
            "message": "Please review and sign this document.", 
            "signatureFlow": "SENDER_SIGNATURE_NOT_REQUIRED", 
            "name": "Demo1", 
            "fileInfos": [{ 
                "transientDocumentId": "XXXXXXXXXX" 
            }], 
            "formFields": [{ 
                    "hidden": "1", 
                    "defaultValue": "test1@gmail.com", 
                    "name": "Signer Email (Applicant-1)", 
                    "inputType": "TEXT_FIELD", 
                    "readOnly": true, 
                    "locations": { 
                        "pageNumber": 1, 
                        "top": 100, 
                        "left": 100, 
                        "width": 100, 
                        "height": 30 
                    }, 
      
                    "contentType": "SIGNER_EMAIL" 
                }, 
                { 
                    "name": "Signature (Applicant-2)", 
                    "inputType": "SIGNATURE", 
                    "locations": { 
                        "pageNumber": 1, 
                        "top": 520, 
                        "left": 162, 
                        "width": 280, 
                        "height": 30 
                    }, 
                    "contentType": "SIGNATURE", 
                    "required": 1, 
                    "recipientIndex": 1 
                }, 
                { 
                    "name": "Signature (Applicant-3)", 
                    "inputType": "SIGNATURE", 
                    "locations": { 
                        "pageNumber": 2, 
                        "top": 312, 
                        "left": 154, 
                        "width": 280, 
                        "height": 30 
                    }, 
                    "contentType": "SIGNATURE", 
                    "required": 1, 
                    "recipientIndex": 1 
                }, 
                { 
                    "defaultValue": "017/09/2018", 
                    "displayFormatType": "DATE", 
                    "name": "Signature Date (Applicant-4)", 
                    "format": "DATE_DD_MM_YYYY", 
                    "inputType": "TEXT_FIELD", 
                    "readOnly": true, 
                    "locations": { 
                        "pageNumber": 2, 
                        "top": 260, 
                        "left": 90, 
                        "width": 80, 
                        "height": 30 
                    }, 
                    "contentType": "DATA", 
                    "required": 1, 
                    "recipientIndex": 1 
                }, 
                { 
                    "name": "Signature (Applicant-5)", 
                    "inputType": "SIGNATURE", 
                    "locations": { 
                        "pageNumber": 3, 
                        "top": 199, 
                        "left": 179, 
                        "width": 276, 
                        "height": 30 
                    }, 
                    "contentType ": "SIGNATURE", 
                    "required": 1, 
                    "recipientIndex": 1 
                }, 
                { 
                    "contentType": "SIGNATURE_DATE", 
                    "defaultValue": "06/07/2018", 
                    "displayFormatType": "DATE", 
                    "name": "Signature Date (Applicant-6)", 
                    "format": "DATE_DD_MM_YYYY", 
                    "inputType": "TEXT_FIELD", 
                    "readOnly": true, 
                    "locations": { 
                        "pageNumber": 3, 
                        "top": 188, 
                        "left": 488, 
                        "width": 76, 
                        "height": 25 
                    }, 
                    "required": 1, 
                    "recipientIndex": 1 
                }, 
                { 
                    "name": "Signature (Applicant-7)", 
                    "inputType": "SIGNATURE", 
                    "locations": { 
                        "pageNumber": 3, 
                        "top": 370, 
                        "left": 37, 
                        "width": 210, 
                        "height": 26 
                    }, 
                    "contentType ": "SIGNATURE", 
                    "required": 1, 
                    "recipientIndex": 2 
                }, 
                { 
                    "contentType ": "SIGNATURE_DATE", 
                    "defaultValue": "01/02/2018", 
                    "name": "Signature Date (Applicant-8)", 
                    "locations": { 
                        "pageNumber": 3, 
                        "top": 370, 
                        "left": 300, 
                        "width": 76, 
                        "height": 26 
                    }, 
                    "required": 1, 
                    "recipientIndex": 2 
      
                } 
            ] 
        } 
    }
  5. For å utføre JSON-forespørselen klikker du på knappen Try it out.

    Webhook UI

    Riktig JSON returnerer svaret med avtale-IDen.

    Webhook UI

  1. Logg deg på Adobe Sign.

  2. Gå til Konto> Adobe Sign API> API-informasjon og klikk på REST API Method Documentation.

    Fnord.

  3. POST / transientDocuments og last opp en fil og opprett en transient Document ID.

  4. Kopier transient Document ID og bruk den i POST /agreements-metoden. Nevn følgende JSON-forespørsel i boksen:

    { 
        "options": { 
            "noChrome": true, 
            "authoringRequested": true 
        }, 
        "documentCreationInfo": { 
            "recipientSetInfos": [{ 
                    "recipientSetRole": "SIGNER", 
                    "recipientSetMemberInfos": [{ 
                        "email": "test1@gmail.com" 
                    }], 
                    "privateMessage": "Hello 1" 
                }, 
                { 
                    "recipientSetRole": "SIGNER", 
                    "recipientSetMemberInfos": [{ 
                        "email": "test2@gmail.com" 
                    }], 
                    "privateMessage": "Hello 44" 
                } 
            ], 
            "signatureType": "ESIGN", 
            "message": "Please review and sign this document.", 
            "locale": "en_US", 
            "signatureFlow": "SENDER_SIGNATURE_NOT_REQUIRED", 
            "formFieldLayerTemplates": [], 
            "name": "Adobe Sign Agreement", 
            "formFields": null, 
            "fileInfos": [{ 
                "libraryDocumentName": null, 
                "transientDocumentId": "XXXXXXXXXXXX" 
            }] 
        } 
    }
  5. For å utføre JSON-forespørselen klikker du på knappen Try it out.

    Fnord.

    Riktig JSON returnerer svaret med avtale-IDen.

    Fnord.

  6. For å åpne avtalen i Authoring-modus kopierer du URL-en og limer den inn i nettleserens adressefelt.

  7. Dra og slipp skjemafeltene på ønsket sted.

  8. Klikk på Send for å sende ut avtalen for signatur. 

Bruk POST /agreements til å opprette en avtale. Sender den ut til signering, og returnerer agreementID-en i svaret til klienten. Nedenfor er JSON-formatet for å sende avtale ved bruk av telefongodkjenningsmetode.

 

{

"documentCreationInfo": {

"mergeFieldInfo": null,

"recipientSetInfos": [{

"signingOrder": null,

"recipientSetRole": "SIGNER",

"recipientSetMemberInfos": [{

"securityOptions": null,

"email": "Signer@email.com"

}],

 

"privateMessage": null,

"securityOptions": [{

"authenticationMethod": "PHONE",

"phoneInfos": [{

"phone": "1111111111",

"countryCode": "+1"

}]

}]

}],

 

"signatureType": "ESIGN",

"callbackInfo": null,

"message": "Please review and sign this document.",

"locale": "en_US",

"vaultingInfo": null,

"securityOptions": null,

"reminderFrequency": null,

"ccs": null,

"postSignOptions": null,

"signatureFlow": "SENDER_SIGNATURE_NOT_REQUIRED",

"daysUntilSigningDeadline": null,

"formFieldLayerTemplates": [],

"name": "Adobe Sign Agreement-Phone authentication testing",

"formFields": null,

"fileInfos": [{

"libraryDocumentName": null,

"transientDocumentId": "3AAABLYourTransactionID",

"documentURL": null,

"libraryDocumentId": null

}]

},

 

"options": {

"autoLoginUser": true,

"authoringRequested": false,

"noChrome": true,

"sendThroughWeb": null,

"sendThroughWebOptions": null,

"locale": "en_US"

}

}

 

Du kan flette dataene direkte i skjemafeltene ved å bruke følgende metoder:

  • Med en bibliotekmal:

    Hvis du bruker en bibliotekmal-ID under FileInfo-parameteren, må du sørge for å oppgi nøyaktig feltnavn og tilhørende data under delen nedenfor:

 

"mergeFieldInfo": [

     {

       "defaultValue": "",

       "fieldName": ""

     }

   ],

 

  • Bruk av tekstkoder i et dokument lastet opp som et transient dokument:

    Hvis du laster opp et dokument som har tekstkoder lagt til som et transient dokument, må du sørge for å oppgi det nøyaktige feltnavnet og tilhørende data under delen nedenfor:

 

"mergeFieldInfo": [

     {

       "defaultValue": "",

       "fieldName": ""

     }

   ],

 

Hvordan sender jeg en avtale ved hjelp av API som har forhåndsutfylte verdier for de spesifikke skjemafeltene (mergefield)?

Forutsetningen for dette kallet er å fullføre trinnet "Transient Upload" og få en "transientDocumentId" (med: secure.na1.echosign.com/public/docs/restapi/v5#!/transientDocuments/createTransientDocument) for å bruke her.

  • Dette kallet inkluderer "mergeFieldInfo"-delen der standardverdier for spesifikke skjemafelt er gitt.
  • Dette forhåndsutfyller dataene fra et annet system i API-kallet.
  • Disse feltene i avtalen er enten redigerbare eller skrivebeskyttede.

 

Forutsetninger:

  1. Transient dokument-ID
  2. Feltnavn og tilhørende verdier

 

Eksempel på forespørselskall:

 

Forespørsel:

POST /api/rest/v5/agreements HTTP/1.1

Host: api.na1.echosign.com (eller du kan angi shard-navn, som du kan finne med kallet getbaseURis: https://secure.na1.echosign.com/public/docs/restapi/v5#!/base_uris/getBaseUris

Access-Token: 2AAABLblqZhA_D1mluNKQP7py5vXtt-1UHl9NR25e_C3LnKTUH14IblbrXODbXGRozyr7ChBkJNM*

x-user-email: sender@yourdomain.com

Content-Type: application/json

Cache-Control: no-cache

 

{

   "documentCreationInfo": {

       "signatureType": "ESIGN",

       "recipientSetInfos": [

           {

               "recipientSetMemberInfos": [

                   {

                       "email": “signerEmail@domain.com"

                   }

               ],

               "recipientSetRole": "SIGNER"

           }

        ],

      

       "signatureFlow": "SENDER_SIGNATURE_NOT_REQUIRED",

       "message": "Please Sign this from us!",

       "fileInfos": [

           {

               "transientDocumentId": "3AAABLblqZhD1uP3ZnkJximC0JV1S677PR5xmybSJ-SJn6OtEy2tVqFyMN4xUAbhKTSkLw2Zb6HEF4zAGsrUd2ycoB8fFHQJhrci0O6267VztmIL4nCicSqvAjO7HckATHAsovVmuYwI9_FDDgHg0ogyti62L13HQFZIQRe9iyQMvvzbmksM7ODNK_HEepEKRCeJTtis9FOlz6uRCcIMNlbX_2GU8utWT"

           }

       ],

       "name": "MSA Edited”,

        "mergeFieldInfo": [

            {

                "fieldName": "AccountName",

                "defaultValue": "Sam's Garage"

            },

            {

                "fieldName": "AccountNumber",

                "defaultValue": "8756999"

            },

            {

                "fieldName": "Zip",

                "defaultValue": "94501"

            },

            {

                "fieldName": "City",

                "defaultValue": "CityVille"

            },

            {

                "fieldName": "State",

                "defaultValue": "CA"

            },

            {

                "fieldName": "Street",

                "defaultValue": "123 Some Road"

            },

            {

                "fieldName": "Title1",

                "defaultValue": "COO"

            },

            {

                "fieldName": "Description",

                "defaultValue": "Some new description here"

            }

        ]

   }

 

}

 

Svaret på dette kallet er "agreementId" som du må lagre i systemet ditt for påfølgende kall (signingUrl, status, formData osv.)

 

Svar:

{

  "agreementId": "3AAABLblqZhCf_7xDcrOgKFwAabp1S-OFfvUdHf2wJsSMwlB95_x_WdUeab67jOkJi1IJzWuSJ0zdNNKugS1blZB4LT5vNVyJ"

}

 

Ved kjøring av metoden "post /megaSigns/{megaSignId}/views", vises feilmeldingen "Requested view is not available for the resource in the current state."

Feilen vises hvis den angitte navneparameterverdien er ugyldig i nedenstående forespørselskode:

{
  "name": " "
}

Hvis for eksempel MegaSign-avtalen allerede er "IN_PROCESS", vil verdien "AUTHORING" gi nevnte feilmelding. Forsikre deg om at den oppgitte verdien du får er i samsvar med gjeldende status for avtalen.

Ved kjøring av metoden "put /megaSigns/{megaSignId}/state", vises feilmeldingen "No value provided for MegaSign cancellation info."

Feilen skyldes at forespørselskoden mangler parameteren: 

 "megaSignCancellationInfo": {
    "comment": "",
    "notifyOthers": false
  }

I stedet for å bruke "Minimal Schema", klikker du på "Complete Model Schema" og oppgir hele forespørselskoden for å kjøre API-kallet.

For å endre statusen for MegaSign-avtalen bruker du put /megaSigns/{megaSignId}/state og utfører følgende trinn:

  1. Gå til REST API-dokumentasjon for V6 og velg metoden  
    put /megaSigns/{megaSignId}/state.
  2. Oppgi Authorization-verdi samt If-Match og megasignID.
    • For å hente megasignID bruker du get /megaSigns
    • For å hente If-Match bruker du get /megaSigns/{megaSignId} og lokaliserer "Etag" under Header
  3. {
      "state": "CANCELED",
      "megaSignCancellationInfo": {
       "comment": "cancel",
       "notifyOthers": false
      }

For å lykkes med å registrere en webhook svarer webhook-URL-en på denne bekreftelsesforespørselen med en 2XX-svarkode, og kan dessuten sende tilbake samme klient-ID-verdi på en av følgende to måter:

  1. I et svarhode X-AdobeSign-ClientId. Det er det samme hodet som sendes i forespørselen, og blir gjentatt i svaret.
  2. I JSON-svarteksten med nøkkelen X-AdobeSign-ClientId og tilhørende verdi den samme klient-ID-en som sendes i forespørselen.

Adobe Sign mottar 2xx-svaret med X-AdobeSign-ClientId. Brukeren kan sjekke om det er konfigurert riktig i webhook eller ikke.

Webhook-URLen reagerer ikke i henhold til forventet virkemåte. For hvert innleggsvarsel som Adobe Sign sender, svarer URL med 2XX-statuskode og sender klient-ID sendt i forespørselshoder (X-AdobeSign-ClientId) tilbake i responshodene.

Fullstendig informasjon finnes her:
https://www.adobe.io/apis/documentcloud/sign/docs.html#!adobedocs/adobe-sign/master/webhooks/webhook_events.md

Når URL-en ikke overholder denne protokollen, anser Adobe Sign at forespørselen ikke er anerkjent, og forsøker å planlegge på nytt i henhold til policy.

Hvis webhooken ikke svarer, og enten maksimumstiden før nytt forsøk eller maksimumsintervallet for nye forsøk overskrides, deaktiveres webhooken.

Dette arbeidet er lisensiert under en Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™- og Facebook-innlegg dekkes ikke under vilkårene for Creative Co


Behandle / få informasjon om avtaler

For å endre dokumentet som allerede er sendt ut for signatur bruker du metoden PUT /agreements/{agreementId} som du kan oppdatere en eksisterende avtale med. Oppgi transient ID sammen med agreement ID i følgende forespørselskode:

 

{

  "documentUpdateInfo": {

    "fileInfos": [

      {

        "agreementDocumentId": "",

        "transientDocumentId": ""

      }

    ]

  }

}

 

Det følgende er instruksjoner for å oppdatere statusen fra "AUTHORING" til "IN_PROCESS" ved hjelp av Put /agreements/{agreementId}/state:

  1. Få agreement-ID hentet ved hjelp av POST /Agreement-metoden.

  2. Bruk Get /agreements/{agreementId} for å hente siste ETag.

  3. Gå til Put /agreements/{agreementId}/ state og oppgi følgende informasjon: "state": "IN_PROCESS"

Nei.

Det er ingen metode i nåværende REST API for å laste opp en signert kopi.

Avsenderen må laste opp den signerte kopien fra Behandle-siden.

DELETE /agreements/ID brukes til å skjule en avtale fra Behandle-siden.

Adobe har det nye API-et PUT /agreements/ID/me/visibility for å kontrollere synligheten av en avtale (i GET /agreements). I tillegg til funksjonaliteten som tilbys av DELETE /agreements/ID, tillater det nye synlighetsendepunktet også en bruker å reversere "skjul" -operasjonen, det vil si gjøre avtalen synlig igjen. 

Du kan også følge de detaljerte trinnene nedenfor:

  1. Gå til metoden get /agreements og hent agreement ID.
  2. Klikk på put /agreements/{agreementId}/me/visibility og oppgi forespørselen nedenfor som eksempel:
    {
      "visibility": "HIDE"
    }
    Agreement ID er bare skjult fra get /libraryDocuments, den er fremdeles synlig på Behandle-fanen i brukergrensesnittet.
Merk:

API Retention-funksjonen er ikke aktivert som standard.

For å aktivere operasjonen DELETE/agreements kontakter du kundeansvarlig og ber om at API Retention blir slått på for kontoen.

For mer informasjon om hvordan du aktiverer Retention-funksjoner for kontoen din kan du se Adobe Sign – dokumentoppbevaring.

  1. Logg på som Adobe Sign-administrator og gå til:  https://secure.adobesign.com/public/docs/restapi/v6

    • Klikk på agreeements og utvid metoden GET /agreements 
    • Klikk på knappen OAUTH ACCESS-TOKEN
    • Aktiver agreement_read:self-omfanget.
    • Klikk på knappen Authorize.
      • Hvis du blir utfordret, klikker du på Allow Access (Gi tilgang)
    • Klikk på knappen Prøv det!-knapp
    Get Agreement-metode

  2. Svaret genereres.

    AgreementID finner du i Response Body:

    Get Agreement-svar

  3. DELETE /agreements/{agreementId}/documents: Sletter alle dokumenter relatert til en avtale. Selve avtalen forblir synlig på siden Behandle.

    • Velg DELETE/agreements-operasjonen som skal kjøres.
    • Klikk på knappen OAUTH ACCESS-TOKEN og opprett tilgangstoken med omfanget areement_retention.
    • Oppgi agreementId for avtalen du vil slette.
    • Når avtalen er slettet, er svarteksten uten innhold.

Du får følgende svar hvis DELETE/agreements-operasjonen ikke er aktivert:

 "code": "DYNAMIC_DOCUMENT_EXPIRATION_NOT_ENABLED",

  "message": "The operation requires some account settings to be enabled. Please contact the Adobe Sign team to enable the settings."

Hvordan laste ned signert dokument sammen med revisjonsrapport og støttedokument gjennom Adobe Sign REST API i stedet for å lage et separat kall for å laste ned revisjonsrapport ved hjelp av følgende metode.

GET /agreements/{agreementId}/auditTrail

  1. Klikk på GET /agreements/{agreementId}/combinedDocument.

  2. Klikk på knappen oAuth Access-token.

  3. Tilgangstoken genereres automatisk når godkjenningen er akseptert.

  4. Oppgi agreementId.

  5. Velg true fra rullegardinmenyen under attachSupportingDocuments.

  6. Velg true fra rullegardinmenyen under attachAuditReport.

  7. Klikk på knappen Prøv det! knappen.

    Hent kombinerte dokumenter

    Laster ned den kombinerte PDF-filen med signert, støttedokument og revisjonsrapport.

For å laste ned mange dokumenter er bare dokumenteksportverktøy tilgjengelig, og med API kan du bare laste ned ett og ett dokument. Det følgende er API-metoden for det samme:

https://secure.na1.adobesign.com/public/docs/restapi/v5#!/agreements/getCombinedDocument


Bibliotekmaler og webskjemaer

  1. Logg på Adobe Sign som administrator og gå til: https://secure.na1.adobesign.com/public/docs/restapi/v6

    • Klikk på libraryDocuments og utvid metoden GET /libraryDocuments
    • Klikk på knappen OAUTH ACCESS-TOKEN
    • Aktiver library_read:self-omfanget.
    • Klikk på knappen Authorize.
      • Hvis du blir utfordret, klikker du på Allow Access (Gi tilgang)
    • Klikk på knappen Prøv det!-knapp
    Get LibraryDocument-metoden

  2. Svaret genereres.

    libraryDocumentId finner du i Response Body:

    Get LibraryDocument-svar

Adobe har det nye API-et PUT/libraryDocuments/ID/me/visibility for å kontrollere synligheten av en avtale (i GET /agreements). I tillegg til funksjonaliteten som tilbys av DELETE /agreements/ID, tillater det nye synlighetsendepunktet også en bruker å reversere "skjul" -operasjonen, det vil si gjøre avtalen synlig igjen.

Du kan følge de detaljerte trinnene nedenfor:

  1. Gå til metoden get /libraryDocuments og hent agreement ID.
  2. Klikk på put /libraryDocuments/{libraryDocumentId}/me/visibility og oppgi forespørselen nedenfor som eksempel:
    {
      "visibility": "HIDE"
    }
    Bibliotek-ID er bare skjult fra get /libraryDocuments, den er fremdeles synlig på Behandle-fanen i brukergrensesnittet.
Merk:
  • Send inn en forespørsel til støtteteamet for å aktivere omfanget for sletting av biblioteket.
  • API sletter bibliotekdokumentet. Avtalene som er opprettet ved bruk av dette bibliotekdokumentet, påvirkes imidlertid ikke.


Generere en libraryDocumentID

  1. Gå til https://secure.echosign.com/public/docs/restapi/v5.

  2. Klikk på libraryDocuments.

  3. Klikk på knappen oAuth Access-token.

    Authorize Access – Token for Self, Group eller Account.

  4. Velg libraryTemplateType - Document eller Form_field_layer.

  5. Klikk på Try it out.

    Du kan motta et svar som dette for alle malene dine. (Kopier libraryDocumentId for bibliotekmalen du vil slette).

    { 
      "libraryDocumentList": [ 
        { 
          "name": "testing fields", 
          "modifiedDate": "2017-08-04T01:06:05-07:00", 
          "scope": "PERSONAL", 
          "libraryDocumentId": "3AAABLblqZhAK53Dvzq88Q1Ov0TEvMAySDPpIVjF1PWgUpy0H1uYggt4iwGiRSZYlWfl9ms_AcmgZ_uZMPPN2hNT9izwaspHc", 
          "libraryTemplateTypes": [ 
            "DOCUMENT" 
          ] 
        },


Slette bibliotekmaler

  1. Kopier libraryDocumentID fra svarteksten.

  2. Gå til Delete libraryDocuments.

  3. Klikk på knappen oAuth Access-token. Authorize Access – Token for Self, Group eller Account.

  4. Lim inn libraryDocumentId i feltet Value.

  5. Klikk på Try it out. 
    Malen slettes.

    Du får følgende svarkode: 204

Merk:

Bare webskjemaer med statusen Draft kan oppdateres.

  1. Opprett widgeten med post /widgets.

  2. Hent widget-ID fra get /widgets.

  3. Etter oppretting med metoden GET /widgets/{widgetId}, henter du Etag fra svarhodet.

    Foo

  4. Bruk Etag fra GET /widgets/{widgetId} under put /widgets/{widgetId}. Oppgi widgetId og widgetInfo under parameteren If-Match.

    Foo

    { 
      "fileInfos": [ 
        { 
          "transientDocumentId": "******" 
        } 
      ], 
      "name": "Widht_Name", 
      "status": "DRAFT", 
      "widgetParticipantSetInfo": { 
        "memberInfos": [ 
          { 
            "email": "" 
          } 
        ], 
        "role": "SIGNER" 
      } 
    }


Brukseksempler

  1. Foreta et get/agreements-kall med riktig x-api-user.

  2. I svarteksten finner du signaturavtalen du vil finne signerings-url for, og noterer agreement ID

  3. Foreta et get/agreements/{agreementId}/signingUrls-kall med agreement ID du mottok fra kallet get/agreements.

     

    Resultat

    Utdataene returnerer e-postadressen til undertegneren/undertegnerne og URL-en for e-signering.

    Get Agreement-metode

Få hjelp raskere og enklere

Ny bruker?