Clarify the two job-offer dates in the page docs

The curl example only showed anzeige_datum, which read as if there's a
single date. Add an explicit list distinguishing Anzeige (anzeige_datum,
sender-provided) from Einspielung (created_at, server-set automatically),
and a comment in the curl body that created_at is not to be sent.

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
2026-07-03 21:58:24 +02:00
co-authored by Claude
parent 5d6fed7041
commit faa3a45815
+6
View File
@@ -138,6 +138,11 @@
Wie werden Jobangebote eingespielt? Wie werden Jobangebote eingespielt?
</summary> </summary>
<div class="mt-3 text-gray-600 dark:text-gray-400 space-y-2"> <div class="mt-3 text-gray-600 dark:text-gray-400 space-y-2">
<p>Jedes Angebot hat zwei Datumswerte:</p>
<ul class="list-disc pl-5 space-y-1 text-xs">
<li><strong>Anzeige</strong> (<code>anzeige_datum</code>) — wann die Stellenanzeige ursprünglich erschienen ist; wird vom Einsender im Request mitgegeben.</li>
<li><strong>Einspielung</strong> (<code>created_at</code>) — wann das Angebot hier im Tracker über die REST-API angekommen ist; wird automatisch vom Server gesetzt, <em>nicht</em> im Request gesendet.</li>
</ul>
<p>Angebot über die REST-API anlegen (API-Key im Header <code>X-API-Key</code>):</p> <p>Angebot über die REST-API anlegen (API-Key im Header <code>X-API-Key</code>):</p>
<pre class="overflow-x-auto rounded-md bg-gray-900 text-gray-100 text-xs px-4 py-3"><code>curl -X POST https://&lt;host&gt;/api/v1/joboffers \ <pre class="overflow-x-auto rounded-md bg-gray-900 text-gray-100 text-xs px-4 py-3"><code>curl -X POST https://&lt;host&gt;/api/v1/joboffers \
-H "X-API-Key: $API_TOKEN" -H "Content-Type: application/json" \ -H "X-API-Key: $API_TOKEN" -H "Content-Type: application/json" \
@@ -152,6 +157,7 @@
"quelle_url": "https://acme.example/job/12345", "quelle_url": "https://acme.example/job/12345",
"art": "Online-Portal", "art": "Online-Portal",
"anzeige_datum": "2026-07-01" "anzeige_datum": "2026-07-01"
// "created_at" (Einspielung) NICHT mitsenden — wird vom Server automatisch gesetzt.
}'</code></pre> }'</code></pre>
<p class="text-xs">Wiederholtes Senden mit derselben <code>quelle</code> + <code>external_id</code> aktualisiert das Angebot (Upsert). Die Doku/Swagger-UI liegt unter <a href="/swagger" class="text-blue-600 dark:text-blue-400 hover:underline">/swagger</a>.</p> <p class="text-xs">Wiederholtes Senden mit derselben <code>quelle</code> + <code>external_id</code> aktualisiert das Angebot (Upsert). Die Doku/Swagger-UI liegt unter <a href="/swagger" class="text-blue-600 dark:text-blue-400 hover:underline">/swagger</a>.</p>
</div> </div>