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:
@@ -138,6 +138,11 @@
|
||||
Wie werden Jobangebote eingespielt?
|
||||
</summary>
|
||||
<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>
|
||||
<pre class="overflow-x-auto rounded-md bg-gray-900 text-gray-100 text-xs px-4 py-3"><code>curl -X POST https://<host>/api/v1/joboffers \
|
||||
-H "X-API-Key: $API_TOKEN" -H "Content-Type: application/json" \
|
||||
@@ -152,6 +157,7 @@
|
||||
"quelle_url": "https://acme.example/job/12345",
|
||||
"art": "Online-Portal",
|
||||
"anzeige_datum": "2026-07-01"
|
||||
// "created_at" (Einspielung) NICHT mitsenden — wird vom Server automatisch gesetzt.
|
||||
}'</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>
|
||||
</div>
|
||||
|
||||
Reference in New Issue
Block a user