From faa3a45815a8583014fa0d2bf7450f27f1905a02 Mon Sep 17 00:00:00 2001 From: Thomas Hackner Date: Fri, 3 Jul 2026 21:58:24 +0200 Subject: [PATCH] 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 --- views/jobangebote.ejs | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/views/jobangebote.ejs b/views/jobangebote.ejs index 49ef7cf..344f50f 100644 --- a/views/jobangebote.ejs +++ b/views/jobangebote.ejs @@ -138,6 +138,11 @@ Wie werden Jobangebote eingespielt?
+

Jedes Angebot hat zwei Datumswerte:

+
    +
  • Anzeige (anzeige_datum) — wann die Stellenanzeige ursprünglich erschienen ist; wird vom Einsender im Request mitgegeben.
    • +
  • Einspielung (created_at) — wann das Angebot hier im Tracker über die REST-API angekommen ist; wird automatisch vom Server gesetzt, nicht im Request gesendet.
    • +

Angebot über die REST-API anlegen (API-Key im Header X-API-Key):

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.
   }'

Wiederholtes Senden mit derselben quelle + external_id aktualisiert das Angebot (Upsert). Die Doku/Swagger-UI liegt unter /swagger.