PATCH /dataset/{schema_name}

Εισαγάγετε ή ενημερώστε μία παραλλαγή εγγράφου ενός προσαρμοσμένου στοιχείου, με κλειδί το αναγνωριστικό του εγγράφου.

Εκτελέστε λειτουργία εισαγωγής ή ενημέρωσης (upsert) για μια παραλλαγή (μία γραμμή documents) ενός προσαρμοσμένου στοιχείου, με κλειδί το id του εγγράφου. Παρέχετε το id για να ενημερώσετε μια υπάρχουσα παραλλαγή· παραλείψτε το για να εισαγάγετε μια νέα. Διατίθεται επίσης στο /schemas/{schema_name}. Το περιεχόμενο επικυρώνεται σε σχέση με το σχήμα του στοιχείου.

Auth: Κλειδί API — απαιτείται πάντα, και το κλειδί πρέπει να διαθέτει την άδεια content_write.

Παράμετροι διαδρομής

Παράμετρος	Τύπος	Υποχρεωτικό	Σημειώσεις
`schema_name`	string	yes	Το όνομα του προσαρμοσμένου στοιχείου.

Παράμετροι ερωτήματος

Παράμετρος	Τύπος	Υποχρεωτικό	Σημειώσεις
`websiteId`	uuid	no	Ιστότοπος-στόχος· προεπιλέγει την επικεφαλίδα `Host` / τη ρύθμιση.
`api_key`	string	no	Εναλλακτική της επικεφαλίδας `x-api-key`.

Σώμα αιτήματος

{
  "id": "<uuid>",
  "title": "Η παραλλαγή μου",
  "content": { "title": "Γεια", "body": "..." }
}

Πεδίο	Τύπος	Υποχρεωτικό	Σημειώσεις
`id`	uuid	no	Ενημερώνει την αντίστοιχη παραλλαγή όταν υπάρχει· εισάγει νέα όταν λείπει ή δεν βρεθεί.
`title`	string	no	Τίτλος εμφάνισης. Προεπιλεγμένη τιμή `"Untitled"` κατά την εισαγωγή· παραμένει αμετάβλητος κατά την ενημέρωση όταν παραλείπεται.
`content`	object	yes	Τιμές πεδίων, επικυρωμένες με βάση το σχήμα του στοιχείου. Πρέπει να είναι αντικείμενο JSON.

Απόκριση

{
  "id": "...",
  "schema_name": "post",
  "title": "Η παραλλαγή μου",
  "status": "πρόχειρο",
  "version": 2,
  "created": true
}

Το created είναι true κατά την εισαγωγή (HTTP 201) και false κατά την ενημέρωση (HTTP 200).

Παράδειγμα

curl -X PATCH '{CMS_API_URL}/dataset/post?websiteId=<uuid>' \
  -H 'x-api-key: <key>' \
  -H 'Content-Type: application/json' \
  -d '{"content":{"title":"Γεια"}}'

Σφάλματα

400 — μη έγκυρο websiteId, content που δεν είναι αντικείμενο, άγνωστο ή αρχειοθετημένο στοιχείο, ή αποτυχία επικύρωσης
401 — ελλείπον ή μη έγκυρο κλειδί API
403 — το κλειδί δεν διαθέτει την άδεια content_write
404 — δόθηκε id αλλά δεν βρέθηκε αντίστοιχη παραλλαγή

Previous‹GET /content-changes (SSE)NextPOST /translation›