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. Dabei beziehen sich die folgenden Werte jeweils auf eine Submission, bzw. auf ein Reply.

• max. Attachmentgröße, verschlüsselt: 500MB
• empfohlende Anzahl Attachments: 30
• max. Anzahl Attachments: 100
• max. Gesamtgröße einer verschlüsselten Submission (Summe aller Attachments einer Submission/Reply): 2GB.

Bei zu vielen parallelen Anfragen wird eine entsprechende Fehlermeldung ausgegeben und die Anfrage muss zu einem späteren Zeitpunkt wiederholt werden. Für die Übermittlung einzelner Dateien, die größer als 200MB sind, wird das Chunking für die Übertragung empfohlen. Eine Beschreibung des Chunkings finden Sie auf der Seite Übertragung großer Attachments.

Die Übertragung von Dateianhängen unterliegt den nachfolgend beschriebenen Einschränkungen. Dabei beziehen sich die folgenden Werte jeweils auf eine Submission, bzw. auf ein Reply.

• max. Attachmentgröße: 500 MB
• max. Anzahl Attachments: 100
• Gesamtgröße (Summe aller Attachments einer Submission / Reply): 2 GB

Bei zu vielen parallelen Anfragen wird eine entsprechende Fehlermeldung ausgegeben und die Anfrage muss zu einem späteren Zeitpunkt wiederholt werden. Für die Übermittlung einzelner Dateien, die größer als 200MB sind, wird das Chunking (siehe Abschnitt [Übertragung großer Attachments](/sdks/java-sdk/sender#Übertragung großer Attachments)) für die Übertragung empfohlen.

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)

Diese Funktionalität wird durch das .NET-SDK intern bereits 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 von FIT-Connect hinterlegt ist. Eine Beschreibung des .NET-SDKs finden Sie im Hauptmenü unter "SDKs > .NET-SDK".

---

curl

$ 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"

JavaScript

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));

Java (SDK)

Anhänge können direkt beim Versand einer Einreichung angegeben werden. Das Java-SDK verschlüsselt anschließend sowohl Fachdaten als auch die Anhänge und führt die notwendigen Aufrufe der FIT-Connect API durch:

var config = ApplicationConfigLoader.loadConfigFromPath(...);
var senderClient = ClientFactory.createSenderClient(config);

var destinationID = UUID.fromString("aa3704d6-8bd7-4d40-a8af-501851f93934");
var serviceIdentifier = "urn:de:fim:leika:leistung:99400048079000";
var serviceSchema = URI.create("https://schema.fitko.de/fim/s00000114_1.1.schema.json");
var jsonData = "{ ... }";
var attachment1 = Attachment.fromPath(Path.of("Anhang1.pdf"), "application/pdf");
var attachment2 = Attachment.fromPath(Path.of("Anhang2.pdf"), "application/pdf");

var submission = SendableSubmission.Builder()
.setDestination(destinationID)
.setServiceType(serviceIdentifier, "My-Service")
.setJsonData(jsonData, serviceSchema)
.addAttachment(attachment1)
.addAttachment(attachment2)
.build();

var sentSubmission = senderClient.send(submission);

C#

// TBD