Brugerhåndbog Annuller

Adobe Acrobat Sign API – ofte stillede spørgsmål

 

Adobe Acrobat Sign-håndbog

Nyheder

  1. Produktbemærkninger før udgivelse
  2. Produktbemærkninger
  3. Vigtige meddelelser

Kom godt i gang

  1. Vejledning til hurtig start for administratorer
  2. Vejledning til hurtig start for brugere
  3. For udviklere
  4. Bibliotek med videoselvstudier
  5. Ofte stillede spørgsmål

Administrer

  1. Oversigt over Admin Console
  2. Brugeradministration
    1. Tilføjelse af brugere
      1. Tilføj en bruger
      2. Opret brugere i massevis
      3. Tilføj brugere fra dit katalog
      4. Tilføj brugere fra MS Azure Active-katalog
    2. Opret funktionsfokuserede brugere
      1. Tekniske konti - API-drevet
      2. Tjenestekonti - manuelt styret
    3. Søg efter brugere med klargøringsfejl
    4. Skift navn/e-mailadresse
    5. Rediger en brugers gruppemedlemskab
    6. Rediger en brugers gruppemedlemskab via gruppegrænsefladen
    7. Forfrem en bruger til en administratorrolle
    8. Brugeridentitetstyper og enkeltlogin
    9. Skift brugeridentitet
    10. Godkend brugere med MS Azure
    11. Godkend brugere med Google-føderation
    12. Produktprofiler
    13. Login-oplevelse 
  3. Konto-/gruppeindstillinger
    1. Oversigt over indstillinger
    2. Globale indstillinger
      1. Kontoniveau og ID
      2. Ny modtageroplevelse
      3. Selvunderskrivelsesarbejdsforløb
      4. Send i massevis
      5. Webformularer
      6. Arbejdsforløb for brugerdefineret afsendelse
      7. Power Automate-arbejdsforløb
      8. Biblioteksdokumenter
      9. Indsaml formulardata med aftaler
      10. Begrænset dokumentsynlighed
      11. Vedhæft en PDF-kopi af den underskrevne aftale 
      12. Inkluder et link i mailen
      13. Medtag et billede i e-mailen
      14. Filer, der vedhæftes i mail, navngives som
      15. Vedhæft redigeringsrapport til dokumenter
      16. Flet flere dokumenter sammen til ét
      17. Download individuelle dokumenter
      18. Upload et underskrevet dokument
      19. Delegering til brugere af min konto
      20. Tillad eksterne modtagere at delegere
      21. Tilladelse til at underskrive
      22. Tilladelse til at sende
      23. Autoritet til at tilføje elektroniske segl
      24. Indstil en standardtidszone
      25. Indstil et standarddatoformat
      26. Brugere i flere grupper (UMG)
        1. Opgrader for at bruge UMG
      27. Tilladelser for gruppeadministratorer
      28. Udskift modtager
      29. Revisionsrapport
        1. Oversigt
        2. Tillad uautoriseret adgang på siden til transaktionsbekræftelse
        3. Medtag påmindelser
        4. Inkluder visningshændelser
        5. Inkluder optælling af aftaleside/vedhæftet fil
      30. Fodnote om transaktion
      31. Beskeder og vejledning i produktet
      32. Tilgængelige PDF'er
      33. Ny oprettelsesoplevelse
      34. Sundhedsplejekunde
    3. Kontoopsætning
      1. Tilføj logo
      2. Tilpas firmaets værtsnavn/URL
      3. Tilføj firmanavn
      4. URL-omdirigering efter aftale
    4. Signaturindstillinger
      1. Velformaterede signaturer
      2. Tillad modtagere at underskrive ved
      3. Underskrivere kan ændre deres navn
      4. Tillad modtagere at bruge deres gemte signatur
      5. Brugerdefinerede vilkår for anvendelse og videregivelse af oplysninger
      6. Naviger modtagere gennem formularfelter
      7. Genstart aftalearbejdsforløb
      8. Afvis at underskrive
      9. Tillad arbejdsforløb for stempler
      10. Kræv, at underskrivere angiver deres titel eller virksomhed
      11. Tillad underskrivere at udskrive og placere en håndskreven signatur
      12. Vis meddelelser ved e-signering
      13. Kræve, at underskrivere bruger en mobilenhed til at oprette deres underskrift
      14. Anmod om IP-adresse fra underskrivere
      15. Udelad firmanavn og titel fra deltagelsesstempler
    5. Digitale signaturer
      1. Oversigt
      2. Download og underskriv med Acrobat
      3. Underskriv med cloudsignaturer
      4. Medtag metadata for identitetsudbydere
      5. Begrænsede udbydere af cloud-signaturer
    6. Elektroniske segl
    7. Digital identitet
      1. Gateway for digital identitet
      2. Politik for identitetskontrol
    8. Rapportindstillinger
      1. Ny rapportoplevelse
      2. Klassiske rapportindstillinger
    9. Sikkerhedsindstillinger
      1. Indstillinger for Single Sign-on
      2. Husk mig-indstillinger
      3. Politik for adgangskode til login
      4. Styrke af login-adgangskode
      5. Varighed af websession
      6. PDF-krypteringstype
      7. API
      8. Adgang for bruger- og gruppeoplysninger
      9. Tilladte IP-områder
      10. Kontodeling
      11. Tilladelser til kontodeling
      12. Kontroller til aftaledeling
      13. Bekræftelse af underskrivers identitet
      14. Adgangskode til underskrivelse af aftaler
      15. Dokumentadgangskodens styrke
      16. Bloker underskrivere efter geolokalitet
      17. Telefongodkendelse
      18. Videnbaseret godkendelse (KBA)
      19. Tillad sideudtrækning
      20. Udløb af dokumentlink
      21. Upload et klientcertifikat til webhooks/tilbagekald
      22. Tidsstempel
    10. Afsendelsesindstillinger
      1. Vis Send-siden efter login
      2. Kræv modtagernavn ved afsendelse
      3. Lås navneværdier for kendte brugere
      4. Tilladte modtagerroller
      5. Tillad e-vidner
      6. Modtagergrupper
      7. CC'er
      8. Adgang til modtagerrapport
      9. Obligatoriske felter
      10. Vedhæftning af dokumenter
      11. Samkopiering af felter
      12. Rediger aftaler
      13. Aftalenavn
      14. Sprog
      15. Private beskeder
      16. Tilladte signaturtyper
      17. Påmindelser
      18. Beskyttelse af underskrevne dokumenter med adgangskode
      19. Send aftalenotifikation via
      20. Muligheder for underskriveridentifikation
        1. Oversigt
        2. Adgangskode for underskriver
        3. Engangsadgangskode via e-mail
        4. Acrobat Sign-godkendelse
        5. Telefongodkendelse
        6. Cloudbaseret digital signatur
        7. Vidensbaseret godkendelse
        8. Id-kort
        9. Rapporter om underskriveridentitet
      21. Indholdsbeskyttelse
      22. Aktivér Notarize-transaktioner
      23. Dokumentudløb
      24. Forhåndsvisning, placer signaturer, og tilføj felter
      25. Rækkefølge for underskrivelse
      26. Liquid-tilstand
      27. Brugerdefinerede arbejdsforløbskontrolelementer
      28. Uploadindstillinger for e-underskrivelsessiden
      29. Omdirigering af bekræftelses-URL efter underskrivelse
    11. Beskedskabeloner
    12. Indstillinger for biomedicin
      1. Oversigt
      2. Gennemtving identitetsgodkendelse
      3. Årsager til underskrivelse
    13. Arbejdsforløbintegration
    14. Notariseringsindstillinger
    15. Integration af betalinger
    16. Underskrivermeddelelser
    17. SAML-indstillinger
      1. SAML-konfiguration
      2. Installer Microsoft Active Directory Federation Service
      3. Installer Okta
      4. Installer OneLogin
      5. Installer Oracle Identity Federation
    18. Dataforvaltning
    19. Tidsstempelindstillinger
    20. Eksternt arkiv
    21. Kontosprog
    22. E-mailindstillinger
      1. E-mailoverskrift/-sidefod billeder
      2. Tillad individuelle brugeres e-mailsidefødder
      3. Tilpas mailen Signatur anmodet om
      4. Tilpas til- og cc-felter
      5. Aktivér notifikationer uden links
      6. Tilpas mailskabeloner
    23. Migrering fra echosign.com til adobesign.com
    24. Konfigurer indstillinger for modtagere
  4. Vejledning om forskriftsmæssige krav
    1. Hjælp til handicappede
      1. Overholdelse af tilgængelighed
      2. Opret tilgængelige formularer med Acrobat til computer
      3. Opret tilgængelige AcroForms
    2. HIPAA
    3. Persondataforordning
      1. GDPR-oversigt
      2. Bortrediger en bruger
      3. Bortrediger en brugers aftaler
    4. 21 CFR del 11 og EudraLex bilag 11
      1. 21 CRF del 11 valideringspakke
      2. 21 CFR og EudraLex bilag 11-håndbog
      3. Analyse af delt ansvar
    5. Kunder i sundhedssektoren
    6. IVES-understøttelse
    7. "Lagring" af aftaler
    8. EU/UK-overvejelser
      1. Grænseoverskridende transaktioner EU/UK og eIDAS
      2. HMLR-krav for elektronisk underskrevne dokumenter
      3. Indvirkningen af Brexit på lovgivningen om e-signaturer i Storbritannien
  5. Download aftaler i massevis
  6. Gør krav på dit domæne 
  7. Rapportér misbrug-links

Send, underskriv og administrer aftaler

  1. Modtagerindstillinger
    1. Annuller en mailpåmindelse
    2. Indstillinger på e-underskrivelsessiden
      1. Oversigt over e-underskrivelsessiden
      2. Åbn for at læse aftalen uden felter
      3. Afvis at underskrive en aftale
      4. Deleger underskrivelsesautoritet
      5. Genstart aftalen
      6. Download en PDF af aftalen
      7. Se aftalens historik
      8. Vis aftalemeddelelserne
      9. Konvertér fra elektronisk til håndskreven signatur
      10. Konvertér fra håndskreven til elektronisk signatur 
      11. Naviger formularfelterne
      12. Ryd dataene fra formularfelterne
      13. Forstørrelse og navigation på e-underskrivelsesside
      14. Skift det sprog, der bruges i aftaleværktøjerne og -oplysningerne
      15. Gennemse de juridiske meddelelser
      16. Juster Acrobat Sign-cookieindstillinger
  2. Send aftaler  
    1. Send sideoversigt
    2. Send en aftale kun til dig selv
    3. Send en aftale til andre
    4. Håndskrevne underskrifter
    5. Modtageres underskrivelsesrækkefølge
    6. Send i massevis
      1. Oversigt over funktionen Send i massevis
      2. Send i massevis – konfiguration af en overordnet skabelon 
      3. Send i massevis – konfiguration af CSV-filen
      4. Annuller en Send i massevis-transaktion
      5. Tilføj påmindelser om at sende i massevis
      6. Rapportering for Send i massevis
  3. Oprettelse af felter i dokumenter
    1. Oprettelsesmiljø i appen
      1. Automatisk feltregistrering
      2. Træk og slip felter ved hjælp af oprettelsesmiljøet
      3. Tildel formularfelter til modtagere
      4. Rollen Forudfyld
      5. Anvend felter med en genanvendelig feltskabelon
      6. Overfør felter til en ny biblioteksskabelon
      7. Opdateret oprettelsesmiljø ved afsendelse af aftaler
    2. Opret formularer med teksttags
    3. Opret formularer med Acrobat (AcroForms)
      1. AcroForm-oprettelse
      2. Oprette tilgængelige PDF-dokumenter
    4. Felter
      1. Felttyper
        1. Almindelige felttyper
        2. Billeder i tekst
        3. Stempelbilleder
      2. Udseende af feltindhold
      3. Feltvalideringer
      4. Værdier for maskerede felter
      5. Indstilling af vis/skjul betingelser
      6. Beregnede felter 
    5. Ofte stillede spørgsmål om oprettelse
  4. Underskriv aftaler
    1. Underskriv aftaler, der er sendt til dig
    2. Udfyld og underskriv
    3. Selvunderskrivelse
  5. Administrer aftaler
    1. Administrer sideoversigt
    2. Deleger aftaler
    3. Udskift modtagere
    4. Begræns dokumentsynlighed 
    5. Annuller en aftale 
    6. Opret nye påmindelser
    7. Gennemgå påmindelser
    8. Annuller en påmindelse
    9. Få adgang til Power Automate-forløb
    10. Flere handlinger ...
      1. Sådan fungerer søgning
      2. Se en aftale
      3. Opret en skabelon fra en aftale
      4. Skjul/vis aftaler fra visning
      5. Upload en underskrevet aftale
      6. Rediger en sendt aftales filer og felter
      7. Rediger en modtagers godkendelsesmetode
      8. Tilføj eller rediger en udløbsdato
      9. Føj en note til aftalen
      10. Del en individuel aftale
      11. Annuller deling af en aftale
      12. Download en individuel aftale
      13. Download de enkelte filer i en aftale
      14. Download revisionsrapporten for en aftale
      15. Download feltindholdet af en aftale
  6. Revisionsrapport
  7. Rapportering og dataeksport
    1. Oversigt
    2. Giv brugere adgang til rapportering
    3. Rapportdiagrammer
      1. Opret en ny rapport
      2. Aftalerapporter
      3. Transaktionsrapporter
      4. Indstillinger for aktivitetsrapport
      5. Rediger en rapport
    4. Dataeksporter 
      1. Sådan oprettes en ny dataeksport
      2. Eksport af webformulardata
      3. Rediger en dataeksport
      4. Opdater dataeksportindholdet
      5. Download dataeksporten
    5. Omdøb en rapport/eksport
    6. Dubler en rapport/eksport
    7. Planlæg en rapport/eksport
    8. Slet en rapport/eksport
    9. Brug af kontroltransaktion

Avancerede aftalefunktioner og arbejdsforløb

  1. Webformularer 
    1. Opret en webformular
    2. Rediger en webformular
    3. Deaktiver/aktivér en webformular
    4. Skjul/vis en webformular
    5. Find URL'en eller scriptkoden 
    6. Forudfyld webformularfelter med URL-parametre
    7. Gem en webformular og færdiggør den senere
    8. Ændr størrelsen på en webformular
  2. Genanvendelige skabeloner (Biblioteksskabeloner) 
    1. Amerikanske regeringsformularer i Acrobat Sign-biblioteket
    2. Opret en biblioteksskabelon
    3. Skift en biblioteksskabelons navn
    4. Skift en biblioteksskabelons type
    5. Skift en biblioteksskabelons tilladelsesniveau
    6. Kopiér, rediger og gem en delt skabelon
    7. Download de aggregerede feltdata for en biblioteksskabelon
  3. Overfør ejerskab af webformularer og biblioteksskabeloner
  4. Power Automate-arbejdsforløb 
    1. Oversigt over Power Automate-integrationen og inkluderede rettigheder
    2. Aktivér Power Automate-integrationen
    3. Kontekstintegrerede handlinger på siden Administrer
    4. Spor Power Automate-brug
    5. Opret et nyt forløb (eksempler)
    6. Udløsere, der bruges til forløb
    7. Import af forløb uden for Acrobat Sign
    8. Administrer forløb
    9. Rediger forløb
    10. Del forløb
    11. Deaktivere eller aktivere forløb
    12. Slet forløb
    13. Nyttige skabeloner
      1. Kun administrator
        1. Gem alle fuldførte dokumenter i SharePoint
        2. Gem alle fuldførte dokumenter i OneDrive for Business
        3. Gem alle fuldførte dokumenter i Google Drev
        4. Gem alle fuldførte dokumenter i Dropbox
        5. Gem alle fuldførte dokumenter i Box
      2. Aftalearkivering
        1. Gem dine afsluttede dokumenter i SharePoint
        2. Gem dine fuldførte dokumenter i OneDrive for Business
        3. Gem dine færdige dokumenter på Google Drev
        4. Gem alle fuldførte dokumenter i Dropbox
        5. Gem dine fuldførte dokumenter i Box
      3. Arkivering af webformularaftaler
        1. Gem udfyldte webformulardokumenter i SharePoint-bibliotek
        2. Gem udfyldte webformulardokumenter i OneDrive for Business
        3. Gem alle fuldførte dokumenter i Google Drive
        4. Arkiver udfyldte webformulardokumenter i Box
      4. Udtrækning af aftaledata
        1. Udtræk formularfeltdata fra dit underskrevne dokument, og opdater Excel-ark
      5. Aftalenotifikationer
        1. Send brugerdefinerede mailnotifikationer med dit aftaleindhold og din underskrevne aftale
        2. Få dine Adobe Acrobat Sign-notifikationer i en Teams-kanal
        3. Få dine Adobe Acrobat Sign-notifikationer i Slack
        4. Få dine Adobe Acrobat Sign-notifikationer på Webex
      6. Aftalegenerering
        1. Generer dokument fra Power App-formular og Word-skabelon, send til underskrivelse
        2. Generér aftale fra Word-skabelon i OneDrive, og få signatur
        3. Generér aftale for markeret Excel-række, send til gennemgang og underskrivelse
  5. Arbejdsforløb for brugerdefineret afsendelse
    1. Overblik over arbejdsforløb for brugerdefineret afsendelse
    2. Oprettelse af et nyt arbejdsforløb for afsendelse
    3. Rediger et Send-arbejdsforløb
    4. Aktivér eller deaktiver et arbejdsforløb for afsendelse
    5. Send en aftale med et arbejdsforløb for afsendelse
  6. Del brugere og aftaler
    1. Del en bruger
    2. Del aftaler

Integrer med andre produkter

  1.  Oversigt over Acrobat Sign-integrationer 
  2. Acrobat Sign til Salesforce
  3. Acrobat Sign til Microsoft
    1. Acrobat Sign til Microsoft 365
    2. Acrobat Sign til Outlook
    3. Acrobat Sign til Word/PowerPoint
    4. Acrobat Sign til Teams
    5. Acrobat Sign til Microsoft PowerApps og Power Automate
    6. Acrobat Sign Connector til Microsoft Search
    7. Acrobat Sign til Microsoft Dynamics 
    8. Acrobat Sign til Microsoft SharePoint 
  4. Andre integrationer
    1. Acrobat Sign til ServiceNow
    2. Acrobat Sign til HR ServiceNow
    3. Acrobat Sign til SAP SuccessFactors
    4. Acrobat Sign til Workday
    5. Acrobat Sign til NetSuite
    6. Acrobat Sign til VeevaVault
    7. Acrobat Sign til Coupa BSM Suite
  5. Partneradministrerede integrationer
  6. Sådan oprettes en integrationsnøgle

Acrobat Sign-udvikler

  1. REST API'er 
    1. Metodedokumentation
    2. SDK/Udviklervejledning
    3. API OFTE STILLEDE SPØRGSMÅL
  2. Webhooks 
    1. Oversigt over Webhook
    2. Konfigurer en ny webhook
    3. Vis eller rediger en webhook
    4. Deaktiver eller genaktiver en webhook
    5. Slet en webhook
    6. Tovejs SSL-certifikater
    7. Webhooks i API'en

Support og fejlfinding

  1. Ressourcer til kundesupport 
  2. Ressourcer til kundesucces for virksomheder 

API-adgang er kun forbeholdt erhvervs- og udviklerkonti.

Links til kernedokumentation

Bemærk:

Support til de ældre SOAP API'er er afsluttet fra maj 2021.

Alle kunder, der bruger SOAP API, skal migrere til REST API så hurtigt som muligt.

Når du er logget på, skal du gå til Konto > Acrobat Sign API > API-oplysninger > REST API'er og dokumentation.


Generelle begreber

Du kan ikke oprette dokumentet ved at vise siden i Web UI eller trække og slippe eller tildele underskriverroller ved hjælp af transientDocumentId via API.

TransientDocuments-kaldet returnerer transientDocumentID, som er gyldig i 7 dage.  Du kan kun bruge det til de yderligere API-kald. Det er gemt på API-serveren og tildelt dette id. Upload en fil, og henvis derefter til dens id i de yderligere API-kald.

Du kan ikke uploade et dokument direkte i aftalen ved hjælp af REST API.

I henhold til REST-kravet skal du først oprette et kortvarigt dokument først og derefter bruge dette id i aftale-, widget- eller biblioteksmetoder som filkilden.

Det kortvarige dokument er en rå kildefil som PDF, doc, docx uploadet til Adobes servere. Så det er en praktisk måde at overføre dit grunddokument til API-serverne og et kortvarigt dokument på nettet.

Ja, du kan sende aftaler ved hjælp af workflows i v6 ved hjælp af API-kald POST /agreements. Godkend workflowId-parameteren i API-kaldet.

Du kan hente workflowId for et workflow ved hjælp af kaldet GET /workflows.

  1. Log på Adobe Sign som en administrator

  2. Gå til Konto > Adobe Sign API > API-anmodningslog

    API-logge

  1.  Log på Adobe Sign som en kontoadministrator

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

  3. Klik på linket REST API-prøver.

    Bemærk:

    Download JavaScript SDK på https://github.com/adobe-sign/AdobeSignJsSdk.

Fra v6 er muligheden "sendTroughWeb" ikke længere tilgængelig. Tilstanden erstatter den. Det er tilstanden, hvori aftalen lander. Tilstandsfeltet kan kun leveres i POST-kald. Det returneres aldrig i GET /agreements/{ID} og ignoreres, hvis det angives i kaldet PUT /agreements/{ID}. Aftalens eventuelle status kan hentes fra GET /agreements/ID.

state(string) = ['AUTHORING' eller 'DRAFT' eller 'IN_PROCESS'].

AUTHORING lader en bruger oprette en aftales dokumenter, før de sendes. Oprettelseshandlingen her refererer til oprettelse, redigering eller placering af formularfelter sammen med deres konfigurationer (tildelt, betingelser, datatype og så videre.) i aftaledokumenterne. Efter at have sendt dokumentet i oprettelsestilstand, er det synligt på i kladdesektionen af fanen Adobe Sign Administrer.

DRAFT er en midlertidig eller primitiv fase af den endelige tilsigtede ressource, som kan opdateres i trin for at oprette den endelige ressource, og er ikke synlig i kladdesektionen af fanen Adobe Sign Administrer. Ved at bruge kladdetilstanden kræves deltagersætinfo ikke, og den kan senere tildele ved oprettelse af PUT /agreements/agreementId for at fuldføre denne kladde. Dette trin kan gentages flere gange, indtil du har alle de nødvendige data til at oprette aftalen.

IN_PROCESS ændrer aftalestatussen til Sendt til underskrivelse og er synlig i sektionen Sendt til underskrivelse på fanen Adobe Sign Administrer.

SendThroughWeb giver dig mulighed for at sende aftalen interaktivt. De forskellige parametre i feltet "muligheder" i v5 POST /agreements-anmodning lader brugeren konfigurere denne interaktive visning (Send-side). Alle disse sidekonfigurationsparametre, såsom fileUploadOptions flyttes til POST agreements/ID/views api.

Så reelt kan du opnå sendThroughWeb ved at oprette en aftale i AUTHORING-tilstand via POST /agreements API. For at bede om URL'en til den næste side i den ønskede konfiguration skal du kalde POST agreements/ID/views API.

Udfør følgende trin:

1. Gå til REST API V6-dokumentation, og vælg metoden POST/agreements.
2. Brug følgende anmodningskode:

{

  "fileInfos": [

    {

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

    }

  ],

  "name": "test",

  "participantSetsInfo": [

    {

      "memberInfos": [

        {

          "email": "abc@gmail.com"

        }

      ],

      "order": 1,

      "role": "SIGNER"

    }

  ],

  "signatureType": "ESIGN",

  "state": "AUTHORING"

}

 

3. Brug nu metoden post /agreements/{agreementId}/views med nedenstående anmodningskode:

 

{

  "name": "AUTHORING"

}

Svarkoden indeholder URL'en til oprettelsesfelter.

Man kan definere tilbagekalds-URL'en på følgende måder:

  • Brug nedenstående parameter til at definere tilbagekalds-URL'en efter behov:

    "callbackInfo": "",
  • Kontakt Adobe Sign-support for at indstille standard-URL'en for tilbagekaldelse for komplet konto.

SOAP UI (SmartBear) får SSL-forbindelsesfejl i stil med den følgende, som du får, når du foretager API-kald. Denne fejl opstår typisk, hvis du bruger forældet SSL- eller TLS-protokol, der er lavere end TLS1.2

FEJL: Undtagelse i anmodning: javax.net.ssl.SSLException: Modtaget kritisk advarsel: protocol_version
FEJL: Der opstod en fejl [Modtaget kritisk advarsel: protocol_version], se detaljer i fejlloggen

  1. Tilføj (-Dsoapui.https.protocols=SSLv3,TLSv1.2) i VMOPTIONS -filen under Bin-mappen.

  2. Gå til C:\Programmer\SmartBear\SoapUI-5.2.1\bin (den afhænger af, om du har installeret SOAP UI. Det kan være under C:\Programmer (x86))

  3. I VMOPTIONS-filen skal du aktivere fuld læse-/skrivetilladelse til filen

    VMOPTIONS

  4. Højreklik på VMOPTIONS-filen> Egenskaber>fanen Sikkerhed>Vælg bruger>Klik på Rediger. (Ikonet for Brugeradgangskontrol vises på knappen Rediger)>Markér alle afkrydsningsfelterne, og klik på OK.

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

  6. Åbn filen via Notesblok.

  7. Tilføj denne protokol i bunden “-Dsoapui.https.protocols=SSLv3,TLSv1.2”, og gem ændringerne.

  8. Luk SOAP UI, og genstart. Det virker uden SSL-fejl, når du foretager API-kald. (Udfør test-ping-kald for at kontrollere).

Gør følgende for at oprette klient-id og klienthemmelighed i Adobe Sign-programmet:

  1. Log på din Adobe Sign-konto.

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

    Fnord.

  3. For at oprette et program skal du klikke på ikonet +.

    Fnord.

  4. Angiv navn og visningsnavn.

  5. Under Domæne skal du vælge KUNDE og klikke på Gem.

    Fnord.

  6. Fremhæv programmet ved at klikke én gang.

  7. Klik på Konfigurer OAuth for programmet.

    Fnord.

  8. Angiv omdirigerings-URI'en.

  9. For at aktivere de nødvendige omfang skal du markere de respektive afkrydsningsfelter og klikke på Gem.

  1. Log på Adobe Sign som en kontoadministrator

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

  3. Klik på linket Integrationsnøgle

    Gå til integrationsnøglen

    Bemærk:

    Hvis du ikke kan se linket til integrationsnøglen, skal du kontakte din Success Manager for at få denne til at aktivere din konto.

    • Navngiv nøglen med en intuitiv værdi
    • Vælg de forskellige Omfang, der kræves til din programfunktion
    • Klik på Gem, når nøglen er fuldt konfigureret
    Grænsefladen for oprettelse af integrationsnøgle

  4. Når nøglen er gemt, kan den findes her: Konto > Personlige indstillinger > Adgangstokens

    Navnet på nøglen og alle de aktiverede omfang er angivet.  

    Klik én gang på nøglebeskrivelsen for at eksponere handlingslinks:

    • Integrationsnøgle – dette link giver den bogstavelige nøgle 
    • Tilbagekald – dette tilbagekalder og sletter adgangstokenen permanent
    Adgangstokens – integrationsnøgle

  1. Log på din Adobe Sign-konto.

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

  3. Klik på ikonet + for at oprette et program.

    Postman1

  4. Klik på Konfigurer OAuth for programmet.

    Fnord.

  5. Generer autorisationskode via følgende link. Klient-id'et, omdirigerings-URI'en og omfang skal være det samme som i følgende URL, som er valgt i programmet (undgå mellemrum i følgende URL, og Shard som 'NA1' tilhører iht. Adobe Sign):

    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 kaldet er vellykket, skal du vælge autorisationskode fra adresselinjen.

    Fnord.

  7. Download og installér Postman fra linket https://www.getpostman.com/apps

  8. Når den er downloadet og installeret, skal du klikke på NY for at oprette en POST.

  9. Skriv linket the https://secure.na1.echosign.com/oauth/token iht. den Adobe Sign-konto, det tilhører.

  10. Under Overskrifter skal du skrive Content-Type som application/x-www-form-urlencoded.

  11. Sørg for, at x-www-form-urlencoded er valgt under Body, og angiv nedenstående parametre med deres tilsvarende værdier fra det program, der blev oprettet i Adobe Sign-kontoen, og klik på SEND.

    Fnord.

  12. Hvis alle oplysningerne er korrekte, returneres adgangstokenen og opdateringstokenen i svaret:

    Fnord.

Mens du kører OAuth Process, skal du følge nedenstående punkter:

1. Korrekt klient-id og omdirigerings-URI er angivet.
2. Omfang, der er angivet i godkendelses-URL, skal matche nøjagtigt med de omfang, der er angivet i Adobe Sign-programmet.
3. Brug det korrekte shard (na1, na2, au1, eu1, jp1) iht. den konto, der konfigureres.
4. Fjern eventuelle mellemrum i godkendelses-URL'en (hvis nogen).
5. Kontrollér godkendelses-URL'ens syntaks:

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

Adgangstokener er kun gyldige i 3600 sekunder (en time), hvorefter de er udløbet.

API-anmodningsindehaveren kan bruge Opdater tokens for at generere nye adgangstokens efter behov.

Webhooks understøttes i REST API v6 og senere.

Hvis en Webhook-modtager ikke reagerer inden for 72 timer, bliver webhook deaktiveret, og der sendes ingen notifikation.

Hvis mål-URL'en til webhooken er nede af en eller anden grund, sætter Adobe Sign JSON i kø og prøver igen i en progressiv cyklus over 72 timer.

De ikke-leverede hændelser bliver vedvarende i en "forsøg igen"-kø, og der gøres den bedste indsats i løbet af de næste 72 timer for at levere notifikationerne i den rækkefølge, de opstod i.

Strategien for at prøve at levere notifikationer igen er en fordobling af tiden mellem forsøg, startende med et interval på 1 minut, der stiger til hver 12. time, hvilket resulterer i 15 forsøg i løbet af 72 timer.

 

For at oprette webhook direkte fra Adobe Sign UI skal du først oprette webhook-URL via Azure AD-funktionsapps via nedenstående trin:

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

  2. Tilmeld dig Funktionsapps under Azure AD-kontoen.

    Azure-menu

  3. Gå til Azure AD, og gå til Funktionsapps > Klik på ikonet + for funktioner.

  4. Vælg Webhook+API med Javascript som sprog, og klik på Opret funktion.

    Azure API UI

  5. Erstat Index.js-filen med følgende kodestykke:

    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. Klik på Test-knappen i det højre hjørne, og angiv følgende overskrift:

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

    API-test

  7. Klik på Gem og Kør.

  8. Når du modtager 200 OK-svar med følgende overskrift, skal du klikke på Hent funktions-URL

    200 svar

  9. Kopiér URL'en, og gå til Adobe Sign UI > Webhooks > Klik på ikonet + for at oprette.

  10. Angiv følgende oplysninger: 

    • Navn: Et intuitivt navn, som andre administratorer nemt kan forstå er foreslået.
    • Omfang: Hvor stort et net webhooken fanger. Konto og Gruppe er tilgængelige i grænsefladen.
      API'en understøtter omfangene Konto, Gruppe, Bruger og Ressource.
    • Der kan kun defineres ét omfang per webhook
    • URL: Den mål-URL, som Adobe Sign skubbede JSON-nyttelasten til.
    • Hændelser: Den udløser, der får Adobe Sign til at oprette JSON og skubbe den til URL'en.
      Hver hændelse bygger en anden nyttelast, der er relevant for udløsningshændelsen
      Flere hændelser kan inkluderes i en webhook.
    • Notifikationsparametre: Notifikationsparameter identificerer sektionerne i Hændelse JSON-nyttelasten, så du kun kan vælge hændelsens sektioner, som er vigtige.
    Webhook UI

  11. Når webhook er fuldt defineret, skal du klikke på Gem, og den nye webhook begynder at reagere for at udløse hændelser med det samme.

Aftaleaktivet refererer til et aktiv, hvorigennem du selv kan oprette en aftale, f.eks. biblioteksdokument, widget og aftale.

For at søge efter aftalens aktivhændelser skal du først lave en anmodning til API'en, der opretter agreementAssetEvents med relevante søgeparametre.

Svaret er den første side med resultater sammen med en søge-id-parameter og markøren for næste side. Du kan bruge den til at hente flere sideresultater, hvis de er tilgængelige via API'en, som henter agreementAssetEvents baseret på søge-id.

  1. Åbn REST API-dokumentationen til version 5.

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

  3. I anmodningskoden skal du definere start- og slutdato i henhold til kravet:

    { 
      "endDate": "2018-05-22T22:33:33", 
      "startDate": "2017-12-22T22:33:33" 
    }
  4. Klik på Prøv det. Det henter aftalens aktiv-id'er, som også kan bruges som aftale-id'er.


Bruger-/kontoadministration

  1. Log på Adobe Sign.
  2. Gå til Konto > Adobe Sign API > REST API-dokumentation.
  3. Vælg Version 5.
  4. Under metoden post /users skal du bruge den anmodningskode, der er nævnt under
    UserCreationInfo method
    {
    "email": "email@email.com",
    "firstName": "AA",
    "lastName": "AB",
    "password":"12******rte"
    }

Adobe Sign-konti, der bruger Admin Console (Adobe One) til at administrere deres brugerrettigheder, kan ikke bruge Adobe Sign API'en til at oprette brugere eller administrere eksisterende brugere.

Adobe One Admin Console bruger en anden API end Adobe Sign API. Se disse artikler for mere information:

 

Hentning af gruppe-id:

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

  2. Klik på grupper under Ressourcer og handlinger.

  3. Klik på GET /groups.

  4. Klik på knappen oAuth-adgangstoken.

  5. Generér adgangstokenen.

  6. Klik på knappen Prøv det.

    Du modtager et svar som følger med gruppens navn og gruppe-id:

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

Sletning af gruppe:

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

  2. For at generere Adgangstoken skal du klikke på knappen oAuth-adgangstoken.

  3. Tilføj groupId, der er modtaget som svar på det forrige kald, som du vil slette i groupId Box.

  4. Klik på Prøv det.

    Du modtager et svar som følger, når gruppen er slettet: Intet indhold

Bemærk:

Du kan ikke slette en gruppe, som en bruger er tildelt. Egentlig kan du kun slette den tomme Gruppe. Du modtager et svar som følger, hvis der er en bruger i gruppen.


{

  "code": "GROUP_NOT_EMPTY",

  "besked": "Gruppen kan ikke slettes, fordi den ikke er tom."

}


Igangsættelse/afsendelse af aftaler

Generering af et kortvarigt dokument

  1. Klik på transientDocuments, og udvid metoden POST /transientDocuments

  2. Klik på knappen OAuth-adgangstoken

    API TransientDocument Method

    • Aktivér Omfang for transaktionen
    • Klik på Godkend
    OAuth-omfang

  3. Giv adgang

    Klik på Giv adgang, hvis du bliver spurgt om det

  4. Du returneres til siden med API-metoder. Godkendelsesværdien er nu udfyldt.

    • Skriv filnavnet i feltet Filnavn
    • Klik på knappen Vælg fil, og upload dokumentet for aftalen
    • Klik på knappen Prøv det!
    Prøv det!

  5. Svaret genereres.

    transientDocumentID kan findes i Svarets brødtekst:

    Kortvarigt dokument-id

Oprettelse af en aftale ved hjælp af det kortvarige dokument

  1. Klik på aftaler, og udvid metoden POST /agreements 

    • Klik på knappen OAuth-adgangstoken
    • Aktivér OAuth-omfanget
    • Klik på Godkend
      • Klik på Giv adgang, hvis du bliver spurgt om det
  2. Du returneres til siden med API-metoder. Godkendelsesværdien er nu udfyldt.

    • Kopiér nedenstående script til en teksteditor (dette script er bare et minimalt konfigureret eksempel; din produktionskode vil være anderledes)
    •  Indsæt din trasientDocumentId-værdi i koden, hvor det er angivet
    { 
      "fileInfos": [ 
       {"transientDocumentId":"PASTE YOUR TRANSIENTDOCUMENTID HERE"} 
      ], 
      "name": "test doc", 
      "participantSetsInfo": [ 
        { 
          "memberInfos": [ 
            { 
              "email": "noreply@echosign.com" 
            } 
          ], 
          "order": 1, 
          "role": "SIGNER" 
        } 
      ], 
      "signatureType": "ESIGN", 
      "state": "DRAFT" 
    }

     

    • Kopiér dit brugerdefinerede script, og indsæt det i feltet AgreementInfo
    • Klik på knappen Prøv det!
    POST-aftalemetode

  3. Svaret genereres.

    agreementID kan findes i Svarets brødtekst:

    POST-aftalemetodesvar

Følgende er trinnene til at tilføje filer i FileInfo Parameter:

  1. Brug kortvarigt id:

    Gå til POST/transientDocuments, og upload det dokument, der skal bruges fra dit lokale system.
    Brug det kortvarige id, der er genereret under sektionen Filinfo i POST/Agreements:

    "fileInfos": [ 
         { 
           "transientDocumentId": "" 
         } 
       ],
  2. Brug biblioteksdokument-id:

    Gå til Dashboard. Klik på Føj dokument til bibliotek, og gem skabelonen.
    Under REST API-dokumentation skal du klikke på GET /libraryDocuments og hente biblioteks-id'et til den skabelon, der oprettes.
    Under POST/Agreements skal du angive biblioteksdokument-id'et:

    "libraryDocumentId": "", 
      "libraryDocumentName": "",
  3. Brug offentligt tilgængelig URL:

    Angiv den offentligt tilgængelige URL, der skal bruges under FileInfo-parameteren:

    { 
          "documentURL": { 
            "mimeType": "", 
            "name": "", 
            "url": "" 
          },
  1. Vælg Aftaler> POST/agreements. 

  2. Vælg Oauth-adgangstoken, og angiv de nødvendige omfang.

  3. Når adgangstokenen er tilføjet, kan du bruge følgende anmodningskode:

    { 
    "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-kald for signaturflow-parameteren kan du godkende værdien SENDER_SIGNS_FIRST eller SENDER_SIGNS_LAST for at tilføje afsenderen som henholdsvis den første eller sidste underskriver.

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

{

  "documentCreationInfo": {

    "fileInfos": [

      {        "transientDocumentId":"3AAABLblqZ-yourIDGoesHere"

      }

    ],

    "name": "Test",

    "recipientSetInfos": [

      {

        "recipientSetMemberInfos": [

          {

            "email": "test@email.com"

          }

        ],

        "recipientSetRole": "SIGNER"

      }

    ],

    "signatureType": "ESIGN",

    "signatureFlow": "SENDER_SIGNS_FIRST"

  }

}

Bemærk:

Muligheden for at sende på vegne er kun tilgængelig i REST API V6 med Avanceret deling aktiveret.

Hvis Send-tilladelse ikke gives i deling, eller hvis Avanceret deling ikke er aktiveret, får du et svar som følger:

 

{"code":"PERMISSION_DENIED","message":"Brugeren, der er angivet i x-på-vegne-af-bruger overskrift har ikke den nødvendige tilladelse til at udføre denne handling."}

 

For funktionen Send på vegne skal du aktivere Avanceret kontodeling for kontoen, så brugerne kan give afsendelsestilladelser til andre brugere, mens de deler deres konto. For Avanceret deling skal du se under Aktivering af avanceret kontodeling.

Når brugerdeling er aktiveret, skal du gennemgå følgende trin for at sende på vegne:

Generering af et kortvarigt dokument:

  1. Under transientDocuments skal du klikke på POST /transientDocuments.

  2. For at generere token til godkendelse skal du klikke på knappen OAUTH-ADGANGSTOKEN.

  3. I x-på-vegne-af-bruger skal du angive mailen på den bruger, du vil sende på vegne af, i følgende format: mail: test@email.com

  4. For at vælge en fil skal du klikke på Vælg fil og klikke på Prøv det.

    Du modtager et svar som følger med transientDocumentId:

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

Generering af en aftale ved hjælp af det kortvarige dokument:

  1. Under aftaler skal du klikke på POST /agreements.

  2. For at generere token til godkendelse skal du klikke på knappen OAUTH-ADGANGSTOKEN.

  3. I x-på-vegne-af-bruger skal du angive brugerens mail, som det gøres ved oprettelse af det kortvarige dokument.

  4. I AgreementInfo skal du tilføje følgende kode og klikke på Prøv det.

    { 
      "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 modtager et svar som følger med agreementId:

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

  2. Gå til  Konto > Adobe Sign API > API-oplysninger, og klik på REST API Method Documentation.

    Webhook UI

  3. POST /transientDocuments, og upload en fil, og opret et kortvarigt dokument-id.

  4. Kopiér det kortvarige dokument-id, og brug det i metoden POST /agreement. Nævn følgende JSON-anmodning i feltet:

    { 
        "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 at udføre JSON-anmodningen skal du klikke på knappen Prøv det.

    Webhook UI

    Den korrekte JSON returnerer svaret med aftale-id'et.

    Webhook UI

Følgende er de parametre, som du kan sende i koden for at indstille åben adgangskode:

 

{

    "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": "Åbn adgangskode for at se dokumentet",

               "securityOptions": {        

            "openPassword": "1234",

                     "protectOpen": true   

        }  

    }]

}

 

For at oprette aftalen ved hjælp af API med tilstanden "AUTHORING" skal du gøre følgende:

Gå til Post /agreements, og opret Adgangstoken med de krævede omfang.

Brug anmodningskoden som følger:

 

{

  "fileInfos": [

    {

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

    }

  ],

  "name": "A1",

  "participantSetsInfo": [

    {

      "memberInfos": [

        {

          "email": "abc@xyz.com"

        }

      ],

      "order": 1,

      "role": "SIGNER"

    }

  ],

  "signatureType": "ESIGN",

  "state": "AUTHORING"

}

 

V6 har et sæt oprettende API'er til at oprette en aftale. I v5 forbruges formFields direkte i POST /agreements api. I v6 kan brugeren dog oprette en aftale i AUTHORING-tilstand (tilstand = AUTHORING) gennem v6 POST /agreements og bruge PUT /agreements/ID/formFields på et senere tidspunkt for at tilføje formularfelter til dokumenterne i denne aftale.

Gør følgende:

  1. Gå til REST API V6-dokumentation, og vælg metoden POST/agreements.

  2. Brug følgende anmodningskode:

    { 
      "fileInfos": [ 
        { 
          "transientDocumentId": "***************************" 
        } 
      ], 
      "name": "test", 
      "participantSetsInfo": [ 
        { 
          "memberInfos": [ 
            { 
              "email": "abc@gmail.com" 
            } 
          ], 
          "order": 1, 
          "role": "SIGNER" 
        } 
      ], 
      "signatureType": "ESIGN", 
      "state": "AUTHORING" 
    }
  3. Brug metoden put /agreements/{agreementId}/formFields med følgende anmodning 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 aftalen til den nævnte modtager, når anmodningen er fuldført.

  1. Log på Adobe Sign.

  2. Gå til  Konto > Adobe Sign API > API-oplysninger, og klik på REST API Method Documentation.

    Webhook UI

  3. POST /transientDocuments, og upload en fil, og opret et kortvarigt dokument-id.

  4. Kopiér det kortvarige dokument-id, og brug det i metoden POST /agreement. Nævn følgende JSON-anmodning i feltet:

    { 
        "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 at udføre JSON-anmodningen skal du klikke på knappen Prøv det.

    Webhook UI

    Den korrekte JSON returnerer svaret med aftale-id'et.

    Webhook UI

  1. Log på Adobe Sign.

  2. Gå til  Konto > Adobe Sign API > API-oplysninger, og klik på REST API Method Documentation.

    Fnord.

  3. POST /transientDocuments, og upload en fil, og opret et kortvarigt dokument-id.

  4. Kopiér det kortvarige dokument-id, og brug det i metoden POST /agreement. Nævn følgende JSON-anmodning i feltet:

    { 
        "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 at udføre JSON-anmodningen skal du klikke på knappen Prøv det.

    Fnord.

    Den korrekte JSON returnerer svaret med aftale-id'et.

    Fnord.

  6. For at åbne aftalen i Authoring Mode skal du kopiere URL'en og indsætte den i en browsers adresselinje.

  7. Træk og slip formularfelterne på det ønskede sted.

  8. For at sende aftalen til underskrivelse skal du klikke på Send. 

Brug POST /agreements til at oprette en aftale. Sender den til underskrivelse og returnerer agreementID i svaret til klienten. Nedenfor er JSON-formatet til afsendelse af aftale med telefongodkendelse.

 

{

"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": "Gennemgå og underskriv dette dokument.",

"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 formularfelterne ved hjælp af følgende metoder:

  • Brug af en biblioteksskabelon:

    Hvis du bruger et biblioteksskabelon-id under FileInfo-parameteren, skal du sørge for at angive det nøjagtige feltnavn og dets tilknyttede data under nedenstående sektion:

 

"mergeFieldInfo": [

     {

       "defaultValue": "",

       "fieldName": ""

     }

   ],

 

  • Brug af teksttags i et dokument, der er uploadet som et kortvarigt dokument:

    Hvis du uploader et dokument, der har teksttags føjet til sig som et kortvarigt dokument, skal du sørge for at angive det nøjagtige feltnavn og dets tilknyttede data under nedenstående sektion: 

 

"mergeFieldInfo": [

     {

       "defaultValue": "",

       "fieldName": ""

     }

   ],

 

Hvordan sendes en aftale ved hjælp af API, der har forudfyldte værdier for de specifikke formularfelter (mergefield)?

Forudsætningen for dette kald er først at gennemføre trinnet "Transient Upload" og opnå et "transientDocumentId" (ved brug af: secure.na1.echosign.com/public/docs/restapi/v5#!/transientDocuments/createTransientDocument), der skal bruges her.

  • Dette kald inkluderer sektionen "mergeFieldInfo", hvor standardværdier for specifikke formularfelter er angivet.
  • Dette forudfylder data fra et andet system i API-kaldet.
  • Disse felter i aftalen er enten redigerbare eller skrivebeskyttede.

 

Forudsætninger:

  1. Kortvarigt dokument-id
  2. Feltnavne og deres værdier

 

Eksempel på anmodning om kald:

 

Anmodning:

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

Vært: api.na1.echosign.com (eller du kan angive dit shard-navn, som du kan finde ved at bruge kaldet getbaseURis: https://secure.na1.echosign.com/public/docs/restapi/v5#!/base_uris/getBaseUris

Adgangstoken: 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 kald er det "agreementId", som du skal gemme i dit system til efterfølgende kald (underskrivelses-URL, status, formulardata osv.)

 

Svar:

{

  "agreementId": "3AAABLblqZhCf_7xDcrOgKFwAabp1S-OFfvUdHf2wJsSMwlB95_x_WdUeab67jOkJi1IJzWuSJ0zdNNKugS1blZB4LT5vNVyJ"

}

 

Når du kører metoden "post /megaSigns/{megaSignId}/views", vises der en fejl som "Den anmodede visning er ikke tilgængelig for ressourcen i den aktuelle tilstand."

Fejlen vises, hvis den angivne navneparameterværdi er ugyldig i nedenstående anmodningskode:

{
  "name": " "
}

For eksempel hvis MegaSign-aftalen allerede er "IN_PROCESS", så giver værdien "AUTHORING" den nævnte fejl. Sørg for, at den angivne værdi er i overensstemmelse med den aktuelle aftaletilstand.

Når du kører metoden "put /megaSigns/{megaSignId}/state", vises der en fejl som "Ingen værdi angivet for MegaSign-annulleringsoplysninger."

Fejlen skyldes, at parameteren mangler i anmodningskoden: 

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

I stedet for at bruge "Minimalt skema" skal du klikke på "Komplet modelskema" og angive den komplette anmodningskode for at køre API-kaldet. 

For at ændre tilstanden af MegaSign-aftalen skal du bruge put /megaSigns/{megaSignId}/state og gøre følgende:

  1. Gå til REST API-dokumentationen for V6, og vælg metoden  
    put /megaSigns/{megaSignId}/state.
  2. Angiv godkendelsesværdien og også If-Match og megasignID.
    • For at hente megasignID skal du bruge get /megaSigns
    • For at hente If-Match skal du bruge get /megaSigns/{megaSignId} og finde "Etag" under overskriften
  3. {
      "state": "CANCELED",
      "megaSignCancellationInfo": {
       "comment": "cancel",
       "notifyOthers": false
      }

For at kunne registrere en webhook reagerer webhook-URL'en på denne verifikationsanmodning med en 2XX-svarkode, og den kan desuden sende den samme klient-id-værdi tilbage på én af følgende to måder:

  1. I en svaroverskrift X-AdobeSign-ClientId. Det er den samme overskrift, der sendes i anmodningen og gentages i svaret.
  2. I JSON-svarets brødtekst, hvor nøglen til X-AdobeSign-ClientId og dens værdi er det samme klient-id, der sendes i anmodningen.

Adobe Sign modtager 2xx-svaret med X-AdobeSign-ClientId. Brugeren kan kontrollere, om det er konfigureret korrekt i webhook eller ej.

Webhook-URL svarer ikke i henhold til den forventede adfærd. For hver Post-notifikation, som Adobe Sign sendte, svarer URL med 2XX-statuskode og gengælder det klient-id, der blev sendt i anmodningsoverskrifter (X-AdobeSign-ClientId), tilbage i svarets overskrifter. 

Få de fulde oplysninger via dette link:
https://www.adobe.io/apis/documentcloud/sign/docs.html#!adobedocs/adobe-sign/master/webhooks/webhook_events.md

Når URL'en ikke overholder denne protokol, tager Adobe Sign højde for, at den ikke har bekræftet anmodningen og forsøgt at omlægge i henhold til den pålidelige politik.

Hvis webhooken ikke svarer, og enten den maksimale forsøgstid eller det maksimale interval for nyt forsøg overskrides, deaktiveres webhooken.

Dette arbejde er licenseret under en Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ og Facebook-indlæg er ikke dækket af Creative Co-vilkårene


Administrer/få oplysninger om aftaler

For at ændre det dokument, der allerede er sendt til underskrivelse, skal du bruge metoden PUT /agreements/{agreementId}, med hvilken du kan opdatere en eksisterende aftale. Angiv det kortvarige id sammen med aftale-id'et i følgende anmodningskode:

 

{

  "documentUpdateInfo": {

    "fileInfos": [

      {

        "agreementDocumentId": "",

        "transientDocumentId": ""

      }

    ]

  }

}

 

Følgende er instruktionerne til at opdatere tilstanden fra "AUTHORING" til "IN_PROCESS" ved hjælp af Put /agreements/{agreementId}/state:

  1. Få aftale-id'et hentet ved hjælp af metoden POST/Agreement.

  2. Brug Get /agreements/{agreementId} for at hente det nyeste ETag.

  3. Gå til Put /agreements/{agreementId}/state, og angiv følgende oplysninger: "state": "IN_PROCESS"

Nej.

Der er ingen metode i den aktuelle REST API til at uploade en underskrevet kopi.

Afsenderen skal uploade den underskrevne kopi på siden Administrer.

DELETE /agreements/ID bruges til at tillade at skjule en aftale fra Administrer-siden.

Adobe har en ny API PUT /agreements/ID/me/visibility til at styre synligheden af en aftale (i GET /agreements). Ud over den funktionalitet, der leveres af DELETE /agreements/ID, giver det nye synlighedsslutpunkt også en bruger mulighed for at fortryde "skjul"-handlingen, dvs. at gøre aftalen synlig igen. 

Du kan også følge de detaljerede trin nedenfor:

  1. Gå til metoden get /agreements, og hent aftale-id'et.
  2. Klik på put /agreements/{agreementId}/me/visibility, og angiv nedenstående anmodning som eksempel:
    {
      "visibility": "HIDE"
    }
    Aftale-id'et er kun skjult for get /libraryDocuments, men det er stadig synligt under Administrer-fanen.
Bemærk:

API-tilbageholdelsesfunktionen er ikke aktiveret som standard.

For at aktivere handlingen DELETE/agreements skal du kontakte din Success Manager og anmode om, at API-tilbageholdelse aktiveres for kontoen.

Få mere at vide om, hvordan du aktiverer tilbageholdelsesfunktionerne for din konto, under Adobe Sign – dokumenttilbageholdelse.

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

    • Klik på agreements, og udvid metoden GET /agreements
    • Klik på knappen  OAUTH ACCESS-TOKEN 
    • Aktivér omfanget agreement_read:self
    • Klik på knappen Godkend.
      • Klik på Giv adgang, hvis du bliver spurgt om det
    • Klik på knappen Prøv det!
    Metoden Get Agreement

  2. Svaret genereres.

     agreementId kan findes i Svarets brødtekst:

    Svaret Get Agreement

  3. DELETE /agreements/{agreementId}/documents: Sletter alle de dokumenter, der er relateret til en aftale. Selve aftalen forbliver synlig på siden Administrer.

    • Vælg handlingen DELETE/agreements, som skal køres.
    • Klik på knappen OAUTH ACCESS-TOKEN, og opret adgangstoken med omfanget areement_retention.
    • Angiv agreementId på den aftale, du vil slette.
    • Når aftalen er slettet, har svarets brødtekst "intet indhold".

Du får følgende svar, hvis handlingen DELETE/agreements ikke er aktiveret:

 "code": "DYNAMIC_DOCUMENT_EXPIRATION_NOT_ENABLED",

  "message": "Handlingen kræver, at nogle kontoindstillinger skal aktiveres. Kontakt Adobe Sign-teamet for at aktivere indstillingerne."

Sådan downloades det underskrevne dokument sammen med revisionsrapport og supplerende dokumenter via Adobe Sign REST API i stedet for at foretage et separat kald for at downloade revisionsrapporten via følgende metode.

GET /agreements/{agreementId}/auditTrail

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

  2. Klik på knappen oAuth-adgangstoken.

  3. Adgangstoken genereres automatisk, når godkendelsen er accepteret.

  4. Angiv agreementId.

  5. Under attachSupportingDocuments skal du vælge true på rullelisten.

  6. Under attachAuditReport skal du vælge true på rullelisten.

  7. Klik på knappen Prøv det! 

    Få kombinerede dokumenter

    Den downloader den kombinerede PDF af Underskrevet, supplerede dokument og revisionsrapport.

For at downloade mange dokumenter på én gang er kun dokumenteksportværktøjet tilgængeligt, og med API kan du kun downloade ét dokument ad gangen. Følgende er API-metoden for samme:

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


Biblioteksskabeloner og webformularer

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

    • Klik på libraryDocuments, og udvid metoden GET /libraryDocuments
    • Klik på knappen  OAUTH ACCESS-TOKEN 
    • Aktivér omfanget library_read:self.
    • Klik på knappen Godkend.
      • Klik på Giv adgang, hvis du bliver spurgt om det
    • Klik på knappen Prøv det!
    Metoden Get LibraryDocument

  2. Svaret genereres.

    libraryDocumentId kan findes i svarets brødtekst:

    Svaret Get LibraryDocument

Adobe har en ny API PUT/libraryDocuments/ID/me/visibility til at styre synligheden af en aftale (i GET /agreements). Ud over den funktionalitet, der leveres af DELETE /agreements/ID, giver det nye synlighedsslutpunkt også en bruger mulighed for at fortryde "skjul"-handlingen, dvs. at gøre aftalen synlig igen.

Du kan følge de detaljerede trin nedenfor:

  1. Gå til metoden get /libraryDocuments, og hent aftale-id'et.
  2. Klik på put /libraryDocuments/{libraryDocumentId}/me/visibility, og angiv nedenstående anmodning som eksempel:
    {
      "visibility": "HIDE"
    }
    Biblioteks-id'et er kun skjult for get /libraryDocuments, men det er stadig synligt under Administrer-fanen.
Bemærk:
  • Send en anmodning med supportteamet for at få omfanget aktiveret til bibliotekssletning.
  • API sletter biblioteksdokumentet. Aftaler, der oprettes med dette biblioteksdokument, påvirkes dog ikke.


Generering af et libraryDocumentID

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

  2. Klik på libraryDocuments.

  3. Klik på knappen oAuth Access-token

    Tillad adgang – token til dig selv, gruppe eller konto.

  4. Vælg libraryTemplateType – Dokument eller Form_field_layer.

  5. Klik på Prøv det.

    Du kan modtage et svar som det følgende for alle dine skabeloner. (Kopiér libraryDocumentId for den biblioteksskabelon, du vil slette).

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


Sletning af biblioteksskabeloner

  1. Kopiér libraryDocumentID fra svarets brødtekst.

  2. Gå til Delete libraryDocuments.

  3. Klik på knappen oAuth-adgangstoken. Tillad adgang – token til dig selv, gruppe eller konto.

  4. Indsæt libraryDocumentId i feltet Værdi.

  5. Klik på Prøv det. 
    Skabelonen slettes.

    Du får følgende svarkode: 204

Bemærk:

Kun webformularer i en Kladde-tilstand kan opdateres.

  1. Opret widget ved hjælp af post /widgets.

  2. Hent widget-id'et fra get/widgets.

  3. Når du har oprettet ved hjælp af metoden GET /widgets/{widgetId}, skal du hente Etag fra svarets brødtekst.

    Foo

  4. Under put  /widgets/{widgetId} skal du bruge Etag fra GET /widgets/{widgetId}. Under If-Match parameteren skal du angive widgetId og widgetInfo.

    Foo

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


Brug caseeksempler

  1. Foretag et get/agreements-kald med den korrekte x-api-user.

  2. I svarets brødtekst skal du finde den aftale, der er sendt til underskrive, og som du vil finde underskrivelses-URL'en for, og du skal notere aftale-id'et

  3. Foretag et get/agreements/{agreementId}/signingUrls-kald ved hjælp af det aftale-id, du modtaget fra kaldet get/agreements.

     

    Resultat

    Outputtet returnerer mailadressen på underskriveren/underskriverne og e-underskrivelses-URL'en.

    Metoden Get Agreement

Få hjælp hurtigere og nemmere

Ny bruger?