From 6c2702c4a715e2334426bf3b01fc789f5fadc59e Mon Sep 17 00:00:00 2001
From: Marco Holz <marco.holz@fitko.de>
Date: Thu, 11 Nov 2021 09:22:32 +0000
Subject: [PATCH] =?UTF-8?q?Hinweise=20auf=20Submission=20API-URL=20und=20O?=
 =?UTF-8?q?Auth-Token-URL=20erg=C3=A4nzt?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/getting-started/authentication.mdx                | 10 +++++++++-
 docs/getting-started/receiving/download-submission.mdx |  6 +++++-
 docs/getting-started/sending/get-destination.mdx       |  4 ++++
 docs/getting-started/sending/start-submission.mdx      |  7 ++++++-
 4 files changed, 24 insertions(+), 3 deletions(-)

diff --git a/docs/getting-started/authentication.mdx b/docs/getting-started/authentication.mdx
index 31ad91de0..cd74b31a7 100644
--- a/docs/getting-started/authentication.mdx
+++ b/docs/getting-started/authentication.mdx
@@ -11,8 +11,12 @@ Als Voraussetzungen hierfür ist es notwendig, Accounts für [API-Clients im Sel
 
 ## Abruf von Access Tokens beim OAuth-Dienst
 
+:::note Hinweis
+Die URL der Submission API und die OAuth-Token-URL finden sich im Artikel [Erste Schritte](overview.md#test-infrastruktur).
+:::
+
 Fast alle Anfragen an die FIT-Connect Submission API müssen authentifiziert werden.
-Hierfür ist ein Access Token notwendig, das beim OAuth-Dienst über die hierfür vorgesehene `Token URL` abgerufen werden kann (siehe Abschnitt `AUTHENTICATION` in der [Schnittstellenspezifikation](../apis/submission-api)).
+Hierfür ist ein Access Token notwendig, das beim OAuth-Dienst über die hierfür vorgesehene OAuth-Token-URL abgerufen werden kann.
 Für den Abruf von Access Tokens ist die [Konfiguration eines API-Client im Self-Service-Portal](../account.mdx) nötig.
 
 Das Token kann anschließend bei Anfragen über den `Authorization` Header mitgeschickt werden.
@@ -115,3 +119,7 @@ POST /applications HTTP/1.1
 Host: api.zustelldienst-01.example.com
 Authorization: Bearer ey...
 ```
+
+:::note Hinweis
+Die URL der Submission API findet sich im Artikel [Erste Schritte](overview.md#test-infrastruktur).
+:::
diff --git a/docs/getting-started/receiving/download-submission.mdx b/docs/getting-started/receiving/download-submission.mdx
index 45b980435..721534fa1 100644
--- a/docs/getting-started/receiving/download-submission.mdx
+++ b/docs/getting-started/receiving/download-submission.mdx
@@ -8,7 +8,9 @@ import ApiLink from '@site/src/components/ApiLink'
 ## Abruf von Metadaten und Fachdaten
 Der Abruf einer Einreichung ist über den Endpunkt <ApiLink to="/v1/submissions/{submissionId}" /> möglich. Liegen zur Einreichung neben den verschlüsselten Metadaten (`encryptedMetadata`) und Fachdaten (`encryptedData`) zusätzlich weitere Anlagen vor, so sind die IDs der Anlagen im Feld `attachments` zu finden. Anlagen müssen separat heruntergeladen werden (siehe nächster Abschnitt).
 
-Anschließend können die Metadaten und Fachdaten [entschlüsselt](./decrypt.mdx) sowie deren Schemata [validiert](./validate.mdx) werden.
+:::note Hinweis
+Die URL der Submission API findet sich im Artikel [Erste Schritte](../overview.md#test-infrastruktur).
+:::
 
 ```bash title="Abfrage der Einreichung inkl. Fachdaten und Metadaten"
 $ export SERVICE_URL=<URL>
@@ -35,6 +37,8 @@ $ curl \
 }
 ```
 
+Anschließend können die Metadaten und Fachdaten [entschlüsselt](./decrypt.mdx) sowie deren Schemata [validiert](./validate.mdx) werden.
+
 ## Abruf von Anlagen
 Anlagen können über den Endpunkt <ApiLink to="/v1/submissions/{submissionId}/attachments/{attachmentId}" /> abgerufen werden. Anschließend können auch die Anlagen [entschlüsselt werden](./decrypt.mdx).
 
diff --git a/docs/getting-started/sending/get-destination.mdx b/docs/getting-started/sending/get-destination.mdx
index ae8333096..47e96518a 100644
--- a/docs/getting-started/sending/get-destination.mdx
+++ b/docs/getting-started/sending/get-destination.mdx
@@ -134,6 +134,10 @@ Diese Informationen sind:
 ### Abruf der Zustellpunkt-Informationen über die Submission API {#submissionapi}
 Zum Abruf der Zustellpunkt-Informationen stellt die Submission API einen Endpunkt bereit, der über Angabe des Parameters `destinationId` die technischen Parameter der Einreichung für den jeweiligen Zustellpunkt ausgibt.
 
+:::note Hinweis
+Die URL der Submission API findet sich im Artikel [Erste Schritte](../overview.md#test-infrastruktur).
+:::
+
 <Tabs
   defaultValue="curl"
   values={[
diff --git a/docs/getting-started/sending/start-submission.mdx b/docs/getting-started/sending/start-submission.mdx
index a9f31943b..00cfd469f 100644
--- a/docs/getting-started/sending/start-submission.mdx
+++ b/docs/getting-started/sending/start-submission.mdx
@@ -14,9 +14,14 @@ Anlagen werden dabei über UUIDs eindeutig identifiziert.
 Die UUIDs der Anlagen müssen eindeutig sein und werden vom sendenden System festgelegt.
 
 :::note Hinweis
-Die Struktur von Einreichungen und die Referenzierung von Fachdatenschemata ist im Artikel [Aufbau einer Einreichung](../submission-structure.mdx) näher beschrieben.
+Die für das Anlegen von Einreichungen notwendige Struktur von Einreichungen und die Referenzierung von Fachdatenschemata ist im Artikel [Aufbau einer Einreichung](../submission-structure.mdx) näher beschrieben.
 :::
 
+:::note Hinweis
+Die URL der Submission API findet sich im Artikel [Erste Schritte](../overview.md#test-infrastruktur).
+:::
+
+
 <Tabs
   defaultValue="curl"
   values={[
-- 
GitLab