{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"789e8490-5888-4223-93f9-7f49c03d6ca4"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"4e13734c-94a8-4ccd-8fb3-1ea7b6d74fe0"}},{"type":"rule"},{"type":"paragraph","content":[{"text":"Über die Connect API können Drittsysteme serverseitig die Dokumentgenerierung von primedocs über die ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://primesoft-group.atlassian.net/wiki/spaces/PDT/pages/310902794"}},{"text":" Schnittstelle nutzen.","type":"text"}]},{"type":"paragraph","content":[{"text":"Als Resultat wird das generierte Dokument dem Aufrufer zurückgegeben.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Authentizierung und Aufruf","type":"text"}]},{"type":"paragraph","content":[{"text":"Um die Connect APIs aufzurufen, muss in der ","type":"text"},{"text":"primedocs.config","type":"text","marks":[{"type":"code"}]},{"text":" solch ein Client registriert sein, siehe hierfür ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://primesoft-group.atlassian.net/wiki/spaces/PDT/pages/193593367"}},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Nach der Registrierung kann damit ein AccessToken vom ","type":"text"},{"text":"IdS","type":"text","marks":[{"type":"code"}]},{"text":" angefordert werden. Mit dem AccessToken kann dann gegen den ","type":"text"},{"text":"Connect/File","type":"text","marks":[{"type":"code"}]},{"text":" Endpunkt der ","type":"text"},{"text":"WebApi","type":"text","marks":[{"type":"code"}]},{"text":" der eigentliche Aufruf abgesetzt werden.","type":"text"}]},{"type":"paragraph","content":[{"text":"Dieses PowerShell-Beispiel zeigt den Bezug des AccessTokens und den Aufruf des Endpunktes:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"powershell"},"content":[{"text":"# Configuration\n$datasourceId = \"b78c3707-d7c7-4fc7-b97f-87d70f63c1ac\"\n$tokenUrl = \"https://customerserver.local/ids/connect/token\"\n$clientID = \"CustomApiClient\"\n$clientSecret = \"CustomClient_Secret_123\"\n$scope = \"pd_ConnectWebApi\"\n\n$tokenRequestHeaders = @{\n \"Content-Type\" = \"application/x-www-form-urlencoded\"\n}\n\n$tokenRequestBody = @{\n client_id = $clientID\n client_secret = $clientSecret\n grant_type = \"client_credentials\"\n scope = $scope\n}\n\n# Request the access token\n\ntry {\n $tokenResponse = Invoke-RestMethod -Uri $tokenUrl -Method POST -Headers $tokenRequestHeaders -Body $tokenRequestBody\n}\ncatch {\n Write-Error \"Error making the request: $_\"\n exit 1;\n}\n\nif (-not $tokenResponse.access_token) {\n Write-Error \"Failed to obtain an access token!\"\n exit 1\n}\n\n# Access token information\nWrite-Host \"Access Token: $($tokenResponse.access_token)\"\n$accessToken = $tokenResponse.access_token\n\n# Prepare headers for request\n$apiRequestHeaders = @{\n \"Authorization\" = \"Bearer $accessToken\"\n}\n\n$xmlBody = @\"\n\n

Browser not supported