Anlagen hochladen

Anlagen sind Bestandteil einer Einreichung und müssen nicht zwingend maschinenlesbar sein. Anlagen können beim Anlegen einer Einreichung angekündigt werden und anschließend über den Endpunkt PUT /v1/submissions/{submissionId}/attachments/{attachmentId} hochgeladen werden.

Vor dem Hochladen von Anlagen müssen diese durch den Sender verschlüsselt werden.

Eine bereits verschlüsselte Datei kann über den Endpunkt PUT /v1/submissions/{submissionId}/attachments/{attachmentId} hochgeladen werden:

Unvollständige Einreichungen, die durch das sendende System (Onlinedienst) nicht abgeschlosen wurden und dem empfangenden System noch nicht bekannt sind, werden nach 1 Tag gelöscht.

Der Endpunkt erwartet genau zwei Parameter:

die Submission-ID der Einreichung, für die eine Anlage hochgeladen werden soll (submissionId), und
die eindeutige ID der Anlage, die hochgeladen werden soll (attachmentId).

Im HTTP-Body der Anfrage erwartet der Endpunkt die verschlüsselte Anlage im JWE-Format (enc_file_content)(siehe Artikel Verschlüsseln).

.NET (SDK)
curl
JavaScript
Java (Spring)
C#

Diese Funktionalität wird durch das .NET-SDK bereits intern umgesetzt und ist durch einen Aufruf der SDK-Methode ClientFactory.GetSenderClient(...).SendAsync(...) automatisch mit abgedeckt:

var sender = ClientFactory
            .GetSenderClient(FitConnectEnvironment.Testing, clientId, clientSecret, logger)
            .SendAsync(sendableSubmission);

Der Quellcode oben ist ein Auszug aus dem Projekt ConsoleAppExample, das im Repository Codebeispiele - examples der FITKO hinterlegt ist. Eine Beschreibung des .NET-SDKs finden Sie im Hauptmenü unter "SDKs > .NET-SDK".

$ export SUBMISSION_API=https://submission-api-testing.fit-connect.fitko.dev
$ export JWT_TOKEN=eyJhbGciOiJIUzI1NiJ9.eyJJc3N1Z...NL-MKFrDGvn9TvkA
$ export SUBMISSION_ID=63f0c991-0635-4e18-8a4b-fb0c01de9f5c
$ export ATTACHMENT_ID=90ae8309-2102-4e81-a325-ceda480d0e9d
$ export ENC_FILE_CONTENT=6r4H2H_WIzCv8Pd-uetmcbK...iVBKF3ylHRUahmZ
$ curl -L -X PUT "$SUBMISSION_API/v1/submissions/$SUBMISSION_ID/attachments/$ATTACHMENT_ID" \
-H "Authorization: Bearer $JWT_TOKEN" \
-H "Content-Type: application/jose" \
--data-raw "$ENC_FILE_CONTENT"

const axios = require('axios');

const data = 'eyJhbGciOiJSU0Et...MRPcWqnLJDtp6ZA0Q';

const SUBMISSION_ID = "a562cf6a-3860-4a7e-96e3-1d01f8a5252d"
const ATTACHMENT_ID = "12399641-2067-4e8b-b049-91b2a6c90544"
const TOKEN = "eyJraWQiOiJHb2JOIiwi...Xh1TWcb2uhLVVnDBQ"
const SUBMISSION_API = "https://submission-api-testing.fit-connect.fitko.dev"

const config = {
method: 'put',
url: SUBMISSION_API + '/v1/submissions/' + SUBMISSION_ID + '/attachments/' + ATTACHMENT_ID,
headers: { 
  'Authorization': 'Bearer ' + TOKEN, 
  'Content-Type': 'application/jose'
},
data : data
};

axios(config)
.then(response => console.log(JSON.stringify(response.data)))
.catch(error => console.log(error));

// TBD

// TBD