diff --git a/docs/details/callbacks.mdx b/docs/details/callbacks.mdx index b02f430d8c022c16d5eefce978b9139cd27cef44..11bf5e6ba89364880edb56039b6f74bf3daed25e 100644 --- a/docs/details/callbacks.mdx +++ b/docs/details/callbacks.mdx @@ -97,13 +97,24 @@ Um [Replay-Angriffe](https://de.wikipedia.org/wiki/Replay-Angriff) zu vermeiden, Dieser Timestamp wird im HTTP-Header `callback-timestamp` übertragen. Bei der Prüfung der Echtheit des ausgelösten Callbacks **MÜSSEN** API-Clients prüfen, dass der angegebene Timestamp nicht älter als **5 Minuten** ist. -Das folgende Beispiel zeigt die Verwendung der HTTP-Header `callback-authentication` und `callback-timestamp`: +Das folgende Beispiel zeigt die Verwendung der HTTP-Header `callback-authentication` und `callback-timestamp`. +Zu beachten ist, dass das Feld `submissionIds` als *deprecated* markiert wurde und durch das Feld `submissions` ersetzt werden soll. ```http POST /callbacks/fit-connect -callback-authentication: 798cd0edb70c08e5b32aa8a18cbbc8ff6b3078c51af6d011ff4e32e470c746234fc4314821fe5185264b029e962bd37de33f3b9fc5f1a93c40ce6672845e90df +callback-authentication: 2056b372b5bcec06d8f11ab79b84b42d6cbe1c8e1178cdfa36e4385dcf717758aaa7599f417d9ec3e079087884f4fd59680bf713621383e2d4414ef74fb10df3 callback-timestamp: 1672527599 -{"type":"https://schema.fitko.de/fit-connect/submission-api/callbacks/new-submissions","submissionIds":["f39ab143-d91a-474a-b69f-b00f1a1873c2"]} +{ + "type":"https://schema.fitko.de/fit-connect/submission-api/callbacks/new-submissions", + "submissionIds":["f39ab143-d91a-474a-b69f-b00f1a1873c2"], + "submissions":[ + { + "destinationId":"d12caea8-f372-4eb1-b102-b0a228253a11", + "submissionId":"f39ab143-d91a-474a-b69f-b00f1a1873c2", + "caseId":"9eec7d3e-dc66-4f82-9f52-1520bf96a32e" + } + ] +} ``` Der HMAC wird gebildet aus dem im HTTP-Header `callback-timestamp` übertragenen Zeitstempel und dem im HTTP-Body übertragenen Payload, getrennt durch das Zeichen `.` (Punkt), jeweils UTF-8-kodiert. Der HMAC wird hexadezimal kodiert übertragen.