Le schermate mostrano l’interfaccia in inglese.
API supporta pagine HTML autonome e pagine inserite in aree di lavoro. page:read, page:write, page:publish, attachment:read e attachment:write sono ambiti separati; si applicano anche i diritti attuali sui documenti e sull'area di lavoro.
POST accetta title, language e html o strutturato content. workspace_slug e opzionale parent_id posizionano la nuova pagina in un'area di lavoro. Senza posizionamento crea una pagina autonoma quando consentito. Il nuovo contenuto dell'area di lavoro inizia come bozza. L'editor autonomo non dispone di un flusso di lavoro di revisione/pubblicazione separato; quelle operazioni restituiscono un conflitto lì.
Il normale flusso dell'area di lavoro è crea → GET bozza → PATCH bozza → revisione → pubblica. L'aggiornamento di una bozza esistente richiede draft_revision e ETag. html è canonico HTML; content contiene blocchi strutturati. GET con rendered=1 aggiunge una vista di lettura; non archiviare l'output renderizzato al posto della fonte canonica. I lettori continuano a vedere la versione pubblicata mentre viene modificata una bozza separata.
La lettura delle versioni rende disponibile la cronologia; il ripristino crea una versione di lavoro senza pubblicarla. La copia di una traduzione richiede source_language e target_language; modifica e pubblicazione della destinazione sono passaggi separati. Entrambe le lingue devono essere installate e abilitate.
attachment è il campo del file in più parti. I caricamenti in blocchi inviano upload_id, original_name, mime_type, file_size, chunk_index (in base zero), chunk_count e attachment. I pezzi intermedi restituiscono 202 e il blocco finale restituisce 201. DELETE .../chunks/{uploadId} annulla un caricamento non completato. Scarica gli allegati tramite /content, non un percorso di archiviazione privato. download=1 richiede la disposizione del download. I campi dei metadati sono display_name, alt_text, caption, description.
PUT attachment-visibility controlla la visualizzazione dell'elenco degli allegati e modifica none, public o authenticated in base al contratto supportato e alle autorizzazioni del documento. L'eliminazione di un allegato potrebbe aggiornare il contenuto della bozza, quindi utilizza l'attuale ETag. L'eliminazione di una bozza di pagina mai pubblicata può comportare la rimozione permanente del documento; scartando una bozza di una pagina pubblicata in precedenza si mantiene la sua versione pubblicata. Da non confondere con l'eliminazione di una pagina pubblicata.
Operazioni ed esempi verificati
GET /api/v1/pages
Scopo: Restituisce le pagine pubblicate visibili al proprietario della chiave API.
Autorizzazione: page:read. Autorizzazioni correnti per documenti e aree di lavoro; l'accesso in lettura, modifica, pubblicazione e agli allegati viene controllato separatamente.
Parametri di query: lang, page[after], page[limit].
Corpo: nessun campo di input aggiuntivo; segui l'esempio.
curl --globoff --silent --show-error \
--request GET \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
"$BASE_URL/api/v1/pages?page[limit]=1&lang=hr"
Risposta effettiva: HTTP 200.
{
"data": [
{
"id": "korisnicke-upute-ankete-izrada-objava--3634a42afb",
"title": "1. Kreirajte nacrt",
"language": "hr",
"default_language": "hr",
"available_languages": [
"en",
"hr"
],
"version_number": 5,
"is_draft": false,
"draft_revision": "",
"attachment_visibility": "none",
"workspace_managed": true,
"contents_visibility": "hidden",
"created_at": "2026-10-27 09:43:15",
"updated_at": "2026-10-27 11:11:07",
"created_by_user_id": 1,
"updated_by_user_id": 1,
"created_by_display_name": "Administrator",
"updated_by_display_name": "Administrator"
}
],
"meta": {
"request_id": "adcdc319e4f744728ad7892844707887",
"page": {
"limit": 1,
"total": 31,
"has_more": true,
"next_cursor": "eyJvZmZzZXQiOjF9"
}
},
"links": {
"self": "/api/v1/pages?page%5Blimit%5D=1&lang=hr",
"next": "/api/v1/pages?page%5Blimit%5D=1&page%5Bafter%5D=eyJvZmZzZXQiOjF9&lang=hr"
}
}
Errori verificati per questa operazione: 401, 403. Consulta regole condivise per i significati dello stato e le risposte ai problemi.
POST /api/v1/pages
Scopo: crea un documento autonomo o una pagina dell'area di lavoro non pubblicata.
Autorizzazione: page:write. Autorizzazioni correnti per documenti e aree di lavoro; l'accesso in lettura, modifica, pubblicazione e agli allegati viene controllato separatamente.
Parametri di query: nessuno.
Corpo/campi supportati: content, contents_visibility, html, language, node_slug, parent_id, slug, title, workspace_slug. L'esempio seguente utilizza valori verificati; le condizioni e le regole di sostituzione delle liste sono descritte all'inizio del capitolo.
curl --globoff --silent --show-error \
--request POST \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--header "Content-Type: application/json" \
--data-raw '{
"title": "Plan API radionice",
"slug": "api-plan-radionice",
"workspace_slug": "api-ogledno-podrucje",
"language": "hr",
"content": [
{
"type": "html",
"html": "<h1>Plan radionice</h1><p>Objasnimo cjelokupni API.</p>"
},
{
"type": "task_list",
"title": "Priprema radionice",
"toggle_scope": "viewers",
"items": [
{
"text": "Pregledati upute"
},
{
"text": "Provjeriti primjer"
}
]
}
]
}' \
"$BASE_URL/api/v1/pages"
Risposta effettiva: HTTP 201.
{
"data": {
"id": "api-plan-radionice",
"title": "Plan API radionice",
"language": "hr",
"default_language": "hr",
"available_languages": [
"hr"
],
"version_number": 1,
"is_draft": true,
"draft_revision": "4665715ff5846b0194bae853acbf4c741e22c8c0f217f133",
"attachment_visibility": "none",
"workspace_managed": true,
"contents_visibility": "inherit",
"created_at": "2026-11-06 22:44:20",
"updated_at": "2026-11-06 22:44:20",
"created_by_user_id": 1,
"updated_by_user_id": 1,
"created_by_display_name": "Administrator",
"updated_by_display_name": "Administrator",
"html": "<h1>Plan radionice</h1>\n<p>Objasnimo cjelokupni API.</p>\n<section class=\"editor-html-task-list\" data-editor-html-task-list=\"1\" data-task-list-uuid=\"076e4a13-3797-4bdd-9fa8-618e832bffd0\" data-task-toggle-scope=\"viewers\" data-task-list-view=\"list\"><h3 class=\"editor-html-task-list-title\">Priprema radionice</h3>\n<ul class=\"editor-html-task-items\">\n<li class=\"editor-html-task-item\" data-task-uuid=\"a7586a8f-d1e7-4bb4-bcb7-2273eb82e923\" data-task-initial-completed=\"0\"><span class=\"editor-html-task-text\">Pregledati upute</span></li>\n<li class=\"editor-html-task-item\" data-task-uuid=\"fd3c4618-f8c2-4cb8-a4a4-fee47435e56b\" data-task-initial-completed=\"0\"><span class=\"editor-html-task-text\">Provjeriti primjer</span></li>\n</ul></section>",
"content": [
{
"type": "html",
"html": "<h1>Plan radionice</h1>\n<p>Objasnimo cjelokupni API.</p>\n"
},
{
"type": "task_list",
"uuid": "076e4a13-3797-4bdd-9fa8-618e832bffd0",
"title": "Priprema radionice",
"toggle_scope": "viewers",
"view": "list",
"headers": [],
"items": [
{
"uuid": "a7586a8f-d1e7-4bb4-bcb7-2273eb82e923",
"text": "Pregledati upute",
"initial_completed": false,
"cells": []
},
{
"uuid": "fd3c4618-f8c2-4cb8-a4a4-fee47435e56b",
"text": "Provjeriti primjer",
"initial_completed": false,
"cells": []
}
]
}
],
"embeds": [
{
"type": "task_list",
"uuid": "076e4a13-3797-4bdd-9fa8-618e832bffd0",
"title": "Priprema radionice",
"toggle_scope": "viewers",
"view": "list",
"headers": [],
"items": [
{
"uuid": "a7586a8f-d1e7-4bb4-bcb7-2273eb82e923",
"text": "Pregledati upute",
"initial_completed": false,
"cells": []
},
{
"uuid": "fd3c4618-f8c2-4cb8-a4a4-fee47435e56b",
"text": "Provjeriti primjer",
"initial_completed": false,
"cells": []
}
]
}
],
"workspace_node": {
"id": 36,
"uuid": "e810e7a1-ff77-42f2-ae4e-57bed7370354",
"workspace_id": 4,
"parent_id": null,
"node_type": "document",
"slug": "api-plan-radionice",
"title": "Plan API radionice",
"title_translations": "{\"en\":\"Plan API radionice\",\"hr\":\"Plan API radionice\"}",
"document_key": "api-plan-radionice",
"route_name": null,
"target_url": null,
"sort_order": 100,
"is_homepage": 1,
"is_tree_hidden": 0,
"is_enabled": 1,
"contents_visibility": "inherit",
"created_by_user_id": 1,
"updated_by_user_id": 1,
"created_at": "2026-11-06 22:44:21",
"updated_at": "2026-11-06 22:44:21"
}
},
"meta": {
"request_id": "e79f9286b26d48ee17b44ecd47d01359"
},
"links": {
"self": "/api/v1/pages"
}
}
Errori verificati per questa operazione: 401, 403. Consulta regole condivise per i significati dello stato e le risposte ai problemi.
DELETE /api/v1/pages/{documentId}
Scopo: Elimina un documento autonomo o una pagina dell'area di lavoro in base ai diritti effettivi.
Autorizzazione: page:write. Autorizzazioni correnti per documenti e aree di lavoro; l'accesso in lettura, modifica, pubblicazione e agli allegati viene controllato separatamente.
Percorso: documentId. Prendi i valori dalla risposta precedente. Un ID di pagina è la chiave del documento; nodeId è numerico e UUID non è uno slug.
Parametri di query: lang.
Corpo: nessun campo di input aggiuntivo; segui l'esempio.
Prima di scrivere: ripeti la richiesta GET e imposta ETAG dalla relativa intestazione ETag.
curl --globoff --silent --show-error \
--request DELETE \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--header "If-Match: $ETAG" \
"$BASE_URL/api/v1/pages/api-plan-radionice?lang=hr"
Risposta effettiva: HTTP 204. Il corpo è vuoto.
Errori verificati per questa operazione: 401, 403. Consulta regole condivise per i significati dello stato e le risposte ai problemi.
GET /api/v1/pages/{documentId}
Scopo: Restituisce solo la versione della pagina pubblicata.
Autorizzazione: page:read. Autorizzazioni correnti per documenti e aree di lavoro; l'accesso in lettura, modifica, pubblicazione e agli allegati viene controllato separatamente.
Percorso: documentId. Prendi i valori dalla risposta precedente. Un ID di pagina è la chiave del documento; nodeId è numerico e UUID non è uno slug.
Parametri di query: lang, rendered.
Corpo: nessun campo di input aggiuntivo; segui l'esempio.
curl --globoff --silent --show-error \
--request GET \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
"$BASE_URL/api/v1/pages/api-plan-radionice?lang=hr&rendered=1"
Risposta effettiva: HTTP 200.
{
"data": {
"id": "api-plan-radionice",
"title": "Plan API radionice",
"language": "hr",
"default_language": "hr",
"available_languages": [
"hr"
],
"version_number": 1,
"is_draft": false,
"draft_revision": "",
"attachment_visibility": "none",
"workspace_managed": true,
"contents_visibility": "inherit",
"created_at": "2026-11-06 22:44:20",
"updated_at": "2026-11-06 22:44:20",
"created_by_user_id": 1,
"updated_by_user_id": 1,
"created_by_display_name": "Administrator",
"updated_by_display_name": "Administrator",
"html": "<h1>Plan radionice</h1>\n<p>Objasnimo cjelokupni API.</p>\n<section class=\"editor-html-task-list\" data-editor-html-task-list=\"1\" data-task-list-uuid=\"076e4a13-3797-4bdd-9fa8-618e832bffd0\" data-task-toggle-scope=\"viewers\" data-task-list-view=\"list\"><h3 class=\"editor-html-task-list-title\">Priprema radionice</h3>\n<ul class=\"editor-html-task-items\">\n<li class=\"editor-html-task-item\" data-task-uuid=\"a7586a8f-d1e7-4bb4-bcb7-2273eb82e923\" data-task-initial-completed=\"0\"><span class=\"editor-html-task-text\">Pregledati upute</span></li>\n<li class=\"editor-html-task-item\" data-task-uuid=\"fd3c4618-f8c2-4cb8-a4a4-fee47435e56b\" data-task-initial-completed=\"0\"><span class=\"editor-html-task-text\">Provjeriti primjer</span></li>\n</ul></section>",
"content": [
{
"type": "html",
"html": "<h1>Plan radionice</h1>\n<p>Objasnimo cjelokupni API.</p>\n"
},
{
"type": "task_list",
"uuid": "076e4a13-3797-4bdd-9fa8-618e832bffd0",
"title": "Priprema radionice",
"toggle_scope": "viewers",
"view": "list",
"headers": [],
"items": [
{
"uuid": "a7586a8f-d1e7-4bb4-bcb7-2273eb82e923",
"text": "Pregledati upute",
"initial_completed": false,
"cells": []
},
{
"uuid": "fd3c4618-f8c2-4cb8-a4a4-fee47435e56b",
"text": "Provjeriti primjer",
"initial_completed": false,
"cells": []
}
]
}
],
"embeds": [
{
"type": "task_list",
"uuid": "076e4a13-3797-4bdd-9fa8-618e832bffd0",
"title": "Priprema radionice",
"toggle_scope": "viewers",
"view": "list",
"headers": [],
"items": [
{
"uuid": "a7586a8f-d1e7-4bb4-bcb7-2273eb82e923",
"text": "Pregledati upute",
"initial_completed": false,
"cells": []
},
{
"uuid": "fd3c4618-f8c2-4cb8-a4a4-fee47435e56b",
"text": "Provjeriti primjer",
"initial_completed": false,
"cells": []
}
]
}
],
"rendered_html": "<h1>Plan radionice</h1>\n<p>Objasnimo cjelokupni API.</p>\n<section class=\"editor-task-list\" data-editor-html-task-list=\"1\" data-task-list-uuid=\"076e4a13-3797-4bdd-9fa8-618e832bffd0\" data-task-toggle-scope=\"viewers\" data-task-list-view=\"list\" data-task-state-url=\"/tasks/state\" data-task-csrf-url=\"/tasks/csrf-token\" data-task-language=\"hr\" data-task-last-changed-label=\"Last changed\" data-task-close-label=\"Close\" data-task-csrf-error=\"CSRF token is unavailable.\" data-task-save-error=\"Task state could not be saved.\" data-task-empty-label=\"No tasks to display.\" data-task-document=\"api-plan-radionice\" data-task-list-label=\"Priprema radionice\"><h3 class=\"editor-html-task-list-title\">Priprema radionice</h3><div class=\"editor-task-list-meta\"><small class=\"editor-task-list-audit\" hidden=\"hidden\"></small></div>\n<ul class=\"editor-html-task-items\">\n<li class=\"editor-task-item\" data-task-uuid=\"a7586a8f-d1e7-4bb4-bcb7-2273eb82e923\" data-task-initial-completed=\"0\"><label class=\"editor-task-control\"><input type=\"checkbox\" class=\"form-check-input editor-task-checkbox\" data-task-uuid=\"a7586a8f-d1e7-4bb4-bcb7-2273eb82e923\" data-task-document=\"api-plan-radionice\" data-task-language=\"hr\" disabled><span class=\"editor-task-text\">Pregledati upute</span></label></li>\n<li class=\"editor-task-item\" data-task-uuid=\"fd3c4618-f8c2-4cb8-a4a4-fee47435e56b\" data-task-initial-completed=\"0\"><label class=\"editor-task-control\"><input type=\"checkbox\" class=\"form-check-input editor-task-checkbox\" data-task-uuid=\"fd3c4618-f8c2-4cb8-a4a4-fee47435e56b\" data-task-document=\"api-plan-radionice\" data-task-language=\"hr\" disabled><span class=\"editor-task-text\">Provjeriti primjer</span></label></li>\n</ul></section>"
},
"meta": {
"request_id": "36c727b5e10aa0addfff223a23e62ae6"
},
"links": {
"self": "/api/v1/pages/api-plan-radionice?lang=hr&rendered=1"
}
}
Errori verificati per questa operazione: 401, 403, 404. Consulta regole condivise per i significati dello stato e le risposte ai problemi.
PATCH /api/v1/pages/{documentId}
Scopo: salva il nuovo contenuto o la bozza dell'area di lavoro condivisa con blocco ottimistico.
Autorizzazione: page:write. Autorizzazioni correnti per documenti e aree di lavoro; l'accesso in lettura, modifica, pubblicazione e agli allegati viene controllato separatamente.
Percorso: documentId. Prendi i valori dalla risposta precedente. Un ID di pagina è la chiave del documento; nodeId è numerico e UUID non è uno slug.
Parametri di query: lang.
Corpo/campi supportati: content, contents_visibility, draft_revision, html, title. L'esempio seguente utilizza valori verificati; le condizioni e le regole di sostituzione delle liste sono descritte all'inizio del capitolo.
Prima di scrivere: ripeti la richiesta GET e imposta ETAG dalla relativa intestazione ETag.
curl --globoff --silent --show-error \
--request PATCH \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--header "Content-Type: application/json" \
--header "If-Match: $ETAG" \
--data-raw '{
"title": "Plan API radionice",
"draft_revision": "4665715ff5846b0194bae853acbf4c741e22c8c0f217f133",
"content": [
{
"type": "html",
"html": "<h1>Plan radionice</h1>\n<p>Objasnimo cjelokupni API.</p>\n"
},
{
"type": "task_list",
"uuid": "076e4a13-3797-4bdd-9fa8-618e832bffd0",
"title": "Priprema radionice",
"toggle_scope": "viewers",
"view": "list",
"headers": [],
"items": [
{
"uuid": "a7586a8f-d1e7-4bb4-bcb7-2273eb82e923",
"text": "Pregledati upute",
"initial_completed": false,
"cells": []
},
{
"uuid": "fd3c4618-f8c2-4cb8-a4a4-fee47435e56b",
"text": "Provjeriti primjer",
"initial_completed": false,
"cells": []
}
]
}
]
}' \
"$BASE_URL/api/v1/pages/api-plan-radionice?lang=hr"
Risposta effettiva: HTTP 200.
{
"data": {
"id": "api-plan-radionice",
"title": "Plan API radionice",
"language": "hr",
"default_language": "hr",
"available_languages": [
"hr"
],
"version_number": 1,
"is_draft": true,
"draft_revision": "c432b67012b68f6e9ceac28a2ab2d32233fae4f41bc6fa8c",
"attachment_visibility": "none",
"workspace_managed": true,
"contents_visibility": "inherit",
"created_at": "2026-11-06 22:44:20",
"updated_at": "2026-11-06 22:44:21",
"created_by_user_id": 1,
"updated_by_user_id": 1,
"created_by_display_name": "Administrator",
"updated_by_display_name": "Administrator",
"html": "<h1>Plan radionice</h1>\n<p>Objasnimo cjelokupni API.</p>\n<section class=\"editor-html-task-list\" data-editor-html-task-list=\"1\" data-task-list-uuid=\"076e4a13-3797-4bdd-9fa8-618e832bffd0\" data-task-toggle-scope=\"viewers\" data-task-list-view=\"list\"><h3 class=\"editor-html-task-list-title\">Priprema radionice</h3>\n<ul class=\"editor-html-task-items\">\n<li class=\"editor-html-task-item\" data-task-uuid=\"a7586a8f-d1e7-4bb4-bcb7-2273eb82e923\" data-task-initial-completed=\"0\"><span class=\"editor-html-task-text\">Pregledati upute</span></li>\n<li class=\"editor-html-task-item\" data-task-uuid=\"fd3c4618-f8c2-4cb8-a4a4-fee47435e56b\" data-task-initial-completed=\"0\"><span class=\"editor-html-task-text\">Provjeriti primjer</span></li>\n</ul></section>",
"content": [
{
"type": "html",
"html": "<h1>Plan radionice</h1>\n<p>Objasnimo cjelokupni API.</p>\n"
},
{
"type": "task_list",
"uuid": "076e4a13-3797-4bdd-9fa8-618e832bffd0",
"title": "Priprema radionice",
"toggle_scope": "viewers",
"view": "list",
"headers": [],
"items": [
{
"uuid": "a7586a8f-d1e7-4bb4-bcb7-2273eb82e923",
"text": "Pregledati upute",
"initial_completed": false,
"cells": []
},
{
"uuid": "fd3c4618-f8c2-4cb8-a4a4-fee47435e56b",
"text": "Provjeriti primjer",
"initial_completed": false,
"cells": []
}
]
}
],
"embeds": [
{
"type": "task_list",
"uuid": "076e4a13-3797-4bdd-9fa8-618e832bffd0",
"title": "Priprema radionice",
"toggle_scope": "viewers",
"view": "list",
"headers": [],
"items": [
{
"uuid": "a7586a8f-d1e7-4bb4-bcb7-2273eb82e923",
"text": "Pregledati upute",
"initial_completed": false,
"cells": []
},
{
"uuid": "fd3c4618-f8c2-4cb8-a4a4-fee47435e56b",
"text": "Provjeriti primjer",
"initial_completed": false,
"cells": []
}
]
}
]
},
"meta": {
"request_id": "78d3a47eb5d697696d041c0eb8270773"
},
"links": {
"self": "/api/v1/pages/api-plan-radionice?lang=hr"
}
}
Errori verificati per questa operazione: 401, 403, 409. Consulta regole condivise per i significati dello stato e le risposte ai problemi.
PUT /api/v1/pages/{documentId}/attachment-visibility
Scopo: modifica la visibilità dell'elenco degli allegati nella visualizzazione della pagina.
Autorizzazione: attachment:write. Autorizzazioni correnti per documenti e aree di lavoro; l'accesso in lettura, modifica, pubblicazione e agli allegati viene controllato separatamente.
Percorso: documentId. Prendi i valori dalla risposta precedente. Un ID di pagina è la chiave del documento; nodeId è numerico e UUID non è uno slug.
Parametri di query: lang.
Corpo/campi supportati: visibility. L'esempio seguente utilizza valori verificati; le condizioni e le regole di sostituzione delle liste sono descritte all'inizio del capitolo.
Prima di scrivere: ripeti la richiesta GET e imposta ETAG dalla relativa intestazione ETag.
curl --globoff --silent --show-error \
--request PUT \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--header "Content-Type: application/json" \
--header "If-Match: $ETAG" \
--data-raw '{
"visibility": "authenticated"
}' \
"$BASE_URL/api/v1/pages/api-plan-radionice/attachment-visibility?lang=hr"
Risposta effettiva: HTTP 200.
{
"data": {
"id": "api-plan-radionice",
"title": "Plan API radionice",
"language": "hr",
"default_language": "hr",
"available_languages": [
"hr"
],
"version_number": 2,
"is_draft": true,
"draft_revision": "630dbf45a41dbf230ff2010a88a5552309f73a82d6ead401",
"attachment_visibility": "authenticated",
"workspace_managed": true,
"contents_visibility": "inherit",
"created_at": "2026-11-06 22:44:20",
"updated_at": "2026-11-06 22:48:21",
"created_by_user_id": 1,
"updated_by_user_id": 1,
"created_by_display_name": "Administrator",
"updated_by_display_name": "Administrator"
},
"meta": {
"request_id": "44dfd16005af547e2c7e9e1f05577e19"
},
"links": {
"self": "/api/v1/pages/api-plan-radionice/attachment-visibility?lang=hr"
}
}
Errori verificati per questa operazione: 401, 403. Consulta regole condivise per i significati dello stato e le risposte ai problemi.
GET /api/v1/pages/{documentId}/attachments
Scopo: Restituisce allegati attivi per una pagina leggibile.
Autorizzazione: attachment:read. Autorizzazioni correnti per documenti e aree di lavoro; l'accesso in lettura, modifica, pubblicazione e agli allegati viene controllato separatamente.
Percorso: documentId. Prendi i valori dalla risposta precedente. Un ID di pagina è la chiave del documento; nodeId è numerico e UUID non è uno slug.
Parametri di query: lang, page[after], page[limit].
Corpo: nessun campo di input aggiuntivo; segui l'esempio.
curl --globoff --silent --show-error \
--request GET \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
"$BASE_URL/api/v1/pages/api-plan-radionice/attachments?lang=hr&page[limit]=1"
Risposta effettiva: HTTP 200.
{
"data": [
{
"uuid": "a458c2aa-62e3-46b3-a262-c4e9376bbc84",
"document_id": "api-plan-radionice",
"original_name": "workshop-notes.txt",
"display_name": "workshop-notes.txt",
"mime_type": "text/plain",
"kind": "file",
"file_size": 19,
"alt_text": "",
"caption": "workshop-notes.txt",
"description": "",
"created_at": "2026-11-06 22:48:20",
"created_by_user_id": 1,
"created_by_display_name": "Administrator",
"version_number": 1,
"version_count": 1
}
],
"meta": {
"request_id": "99676c040a6c38d63fa6f6f9793c9692",
"page": {
"limit": 1,
"total": 1,
"has_more": false,
"next_cursor": null
}
},
"links": {
"self": "/api/v1/pages/api-plan-radionice/attachments?lang=hr&page%5Blimit%5D=1",
"next": null
}
}
Errori verificati per questa operazione: 401, 403. Consulta regole condivise per i significati dello stato e le risposte ai problemi.
POST /api/v1/pages/{documentId}/attachments
Scopo: Memorizza un allegato multiparte standard.
Autorizzazione: attachment:write. Autorizzazioni correnti per documenti e aree di lavoro; l'accesso in lettura, modifica, pubblicazione e agli allegati viene controllato separatamente.
Percorso: documentId. Prendi i valori dalla risposta precedente. Un ID di pagina è la chiave del documento; nodeId è numerico e UUID non è uno slug.
Parametri di query: lang.
Corpo/campi supportati: attachment. L'esempio seguente utilizza valori verificati; le condizioni e le regole di sostituzione delle liste sono descritte all'inizio del capitolo.
curl --globoff --silent --show-error \
--request POST \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--form 'attachment=@./workshop-notes.txt;type=text/plain' \
"$BASE_URL/api/v1/pages/api-plan-radionice/attachments?lang=hr"
Risposta effettiva: HTTP 201.
{
"data": {
"uuid": "a458c2aa-62e3-46b3-a262-c4e9376bbc84",
"document_id": "api-plan-radionice",
"original_name": "workshop-notes.txt",
"display_name": "workshop-notes.txt",
"mime_type": "text/plain",
"kind": "file",
"file_size": 19,
"alt_text": "",
"caption": "workshop-notes.txt",
"description": "",
"created_at": "2026-11-06 22:48:20",
"created_by_user_id": 1,
"created_by_display_name": "Administrator",
"version_number": 1,
"version_count": 1
},
"meta": {
"request_id": "6329eb37cd6d687d577f7abdcb545bf1"
},
"links": {
"self": "/api/v1/pages/api-plan-radionice/attachments?lang=hr"
}
}
Errori verificati per questa operazione: 401, 403, 422. Consulta regole condivise per i significati dello stato e le risposte ai problemi.
POST /api/v1/pages/{documentId}/attachments/chunks
Scopo: Memorizza un pezzo di allegato di grandi dimensioni; il pezzo finale restituisce la risorsa completata.
Autorizzazione: attachment:write. Autorizzazioni correnti per documenti e aree di lavoro; l'accesso in lettura, modifica, pubblicazione e agli allegati viene controllato separatamente.
Percorso: documentId. Prendi i valori dalla risposta precedente. Un ID di pagina è la chiave del documento; nodeId è numerico e UUID non è uno slug.
Parametri di query: lang.
Corpo/campi supportati: attachment, chunk_count, chunk_index, file_size, mime_type, original_name, upload_id. L'esempio seguente utilizza valori verificati; le condizioni e le regole di sostituzione delle liste sono descritte all'inizio del capitolo.
curl --globoff --silent --show-error \
--request POST \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--form upload_id=manual-f64d9f4c2b284d2e \
--form original_name=large-notes.txt \
--form mime_type=text/plain \
--form file_size=12 \
--form chunk_index=0 \
--form chunk_count=2 \
--form 'attachment=@./chunk.part;type=application/octet-stream' \
"$BASE_URL/api/v1/pages/api-plan-radionice/attachments/chunks?lang=hr"
Risposta effettiva: HTTP 202.
{
"data": null,
"meta": {
"request_id": "d706442ad663a28034a5dcc4a8a29c67"
},
"links": {
"self": "/api/v1/pages/api-plan-radionice/attachments/chunks?lang=hr"
}
}
Errori verificati per questa operazione: 401, 403. Consulta regole condivise per i significati dello stato e le risposte ai problemi.
DELETE /api/v1/pages/{documentId}/attachments/chunks/{uploadId}
Scopo: Annulla un caricamento di grandi dimensioni e rimuove i blocchi già trasferiti.
Autorizzazione: attachment:write. Autorizzazioni correnti per documenti e aree di lavoro; l'accesso in lettura, modifica, pubblicazione e agli allegati viene controllato separatamente.
Percorso: documentId, uploadId. Prendi i valori dalla risposta precedente. Un ID di pagina è la chiave del documento; nodeId è numerico e UUID non è uno slug.
Parametri di query: lang.
Corpo: nessun campo di input aggiuntivo; segui l'esempio.
curl --globoff --silent --show-error \
--request DELETE \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
"$BASE_URL/api/v1/pages/api-plan-radionice/attachments/chunks/manual-f64d9f4c2b284d2e?lang=hr"
Risposta effettiva: HTTP 204. Il corpo è vuoto.
Errori verificati per questa operazione: 401, 403. Consulta regole condivise per i significati dello stato e le risposte ai problemi.
DELETE /api/v1/pages/{documentId}/attachments/{assetUuid}
Scopo: Elimina un allegato e rimuove i relativi riferimenti da tutto il contenuto locale.
Autorizzazione: attachment:write. Autorizzazioni correnti per documenti e aree di lavoro; l'accesso in lettura, modifica, pubblicazione e agli allegati viene controllato separatamente.
Percorso: documentId, assetUuid. Prendi i valori dalla risposta precedente. Un ID di pagina è la chiave del documento; nodeId è numerico e UUID non è uno slug.
Parametri di query: lang.
Corpo/campi supportati: html, title. L'esempio seguente utilizza valori verificati; le condizioni e le regole di sostituzione delle liste sono descritte all'inizio del capitolo.
Prima di scrivere: ripeti la richiesta GET e imposta ETAG dalla relativa intestazione ETag.
curl --globoff --silent --show-error \
--request DELETE \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--header "If-Match: $ETAG" \
"$BASE_URL/api/v1/pages/api-plan-radionice/attachments/a458c2aa-62e3-46b3-a262-c4e9376bbc84?lang=hr"
Risposta effettiva: HTTP 200.
{
"data": {
"id": "api-plan-radionice",
"title": "Plan API radionice",
"language": "hr",
"default_language": "hr",
"available_languages": [
"hr"
],
"version_number": 2,
"is_draft": true,
"draft_revision": "630dbf45a41dbf230ff2010a88a5552309f73a82d6ead401",
"attachment_visibility": "authenticated",
"workspace_managed": true,
"contents_visibility": "inherit",
"created_at": "2026-11-06 22:44:20",
"updated_at": "2026-11-06 22:48:21",
"created_by_user_id": 1,
"updated_by_user_id": 1,
"created_by_display_name": "Administrator",
"updated_by_display_name": "Administrator",
"html": "<h1>Plan radionice</h1>\n<p>Objasnimo cjelokupni API.</p>\n<section class=\"editor-html-task-list\" data-editor-html-task-list=\"1\" data-task-list-uuid=\"076e4a13-3797-4bdd-9fa8-618e832bffd0\" data-task-toggle-scope=\"viewers\" data-task-list-view=\"list\"><h3 class=\"editor-html-task-list-title\">Priprema radionice</h3>\n<ul class=\"editor-html-task-items\">\n<li class=\"editor-html-task-item\" data-task-uuid=\"a7586a8f-d1e7-4bb4-bcb7-2273eb82e923\" data-task-initial-completed=\"0\"><span class=\"editor-html-task-text\">Pregledati upute</span></li>\n<li class=\"editor-html-task-item\" data-task-uuid=\"fd3c4618-f8c2-4cb8-a4a4-fee47435e56b\" data-task-initial-completed=\"0\"><span class=\"editor-html-task-text\">Provjeriti primjer</span></li>\n</ul></section>",
"content": [
{
"type": "html",
"html": "<h1>Plan radionice</h1>\n<p>Objasnimo cjelokupni API.</p>\n"
},
{
"type": "task_list",
"uuid": "076e4a13-3797-4bdd-9fa8-618e832bffd0",
"title": "Priprema radionice",
"toggle_scope": "viewers",
"view": "list",
"headers": [],
"items": [
{
"uuid": "a7586a8f-d1e7-4bb4-bcb7-2273eb82e923",
"text": "Pregledati upute",
"initial_completed": false,
"cells": []
},
{
"uuid": "fd3c4618-f8c2-4cb8-a4a4-fee47435e56b",
"text": "Provjeriti primjer",
"initial_completed": false,
"cells": []
}
]
}
],
"embeds": [
{
"type": "task_list",
"uuid": "076e4a13-3797-4bdd-9fa8-618e832bffd0",
"title": "Priprema radionice",
"toggle_scope": "viewers",
"view": "list",
"headers": [],
"items": [
{
"uuid": "a7586a8f-d1e7-4bb4-bcb7-2273eb82e923",
"text": "Pregledati upute",
"initial_completed": false,
"cells": []
},
{
"uuid": "fd3c4618-f8c2-4cb8-a4a4-fee47435e56b",
"text": "Provjeriti primjer",
"initial_completed": false,
"cells": []
}
]
}
]
},
"meta": {
"request_id": "0c1fe4209a148857dd770085a1a05524"
},
"links": {
"self": "/api/v1/pages/api-plan-radionice/attachments/a458c2aa-62e3-46b3-a262-c4e9376bbc84?lang=hr"
}
}
Errori verificati per questa operazione: 401, 403. Consulta regole condivise per i significati dello stato e le risposte ai problemi.
GET /api/v1/pages/{documentId}/attachments/{assetUuid}
Scopo: Restituisce i metadati per un allegato.
Autorizzazione: attachment:read. Autorizzazioni correnti per documenti e aree di lavoro; l'accesso in lettura, modifica, pubblicazione e agli allegati viene controllato separatamente.
Percorso: documentId, assetUuid. Prendi i valori dalla risposta precedente. Un ID di pagina è la chiave del documento; nodeId è numerico e UUID non è uno slug.
Parametri di query: lang.
Corpo: nessun campo di input aggiuntivo; segui l'esempio.
curl --globoff --silent --show-error \
--request GET \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
"$BASE_URL/api/v1/pages/api-plan-radionice/attachments/a458c2aa-62e3-46b3-a262-c4e9376bbc84?lang=hr"
Risposta effettiva: HTTP 200.
{
"data": {
"uuid": "a458c2aa-62e3-46b3-a262-c4e9376bbc84",
"document_id": "api-plan-radionice",
"original_name": "workshop-notes.txt",
"display_name": "workshop-notes.txt",
"mime_type": "text/plain",
"kind": "file",
"file_size": 19,
"alt_text": "",
"caption": "workshop-notes.txt",
"description": "",
"created_at": "2026-11-06 22:48:20",
"created_by_user_id": 1,
"created_by_display_name": "Administrator",
"version_number": 1,
"version_count": 1
},
"meta": {
"request_id": "996c39d94443a701c7f595c7f8fc4044"
},
"links": {
"self": "/api/v1/pages/api-plan-radionice/attachments/a458c2aa-62e3-46b3-a262-c4e9376bbc84?lang=hr"
}
}
Errori verificati per questa operazione: 401, 403. Consulta regole condivise per i significati dello stato e le risposte ai problemi.
PATCH /api/v1/pages/{documentId}/attachments/{assetUuid}
Scopo: Aggiorna parzialmente i metadati di visualizzazione degli allegati.
Autorizzazione: attachment:write. Autorizzazioni correnti per documenti e aree di lavoro; l'accesso in lettura, modifica, pubblicazione e agli allegati viene controllato separatamente.
Percorso: documentId, assetUuid. Prendi i valori dalla risposta precedente. Un ID di pagina è la chiave del documento; nodeId è numerico e UUID non è uno slug.
Parametri di query: lang.
Corpo/campi supportati: alt_text, caption, description, display_name. L'esempio seguente utilizza valori verificati; le condizioni e le regole di sostituzione delle liste sono descritte all'inizio del capitolo.
Prima di scrivere: ripeti la richiesta GET e imposta ETAG dalla relativa intestazione ETag.
curl --globoff --silent --show-error \
--request PATCH \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--header "Content-Type: application/json" \
--header "If-Match: $ETAG" \
--data-raw '{
"display_name": "Workshop notes",
"alt_text": "Notes for the API workshop",
"caption": "Workshop notes",
"description": "Synthetic text attachment."
}' \
"$BASE_URL/api/v1/pages/api-plan-radionice/attachments/a458c2aa-62e3-46b3-a262-c4e9376bbc84?lang=hr"
Risposta effettiva: HTTP 200.
{
"data": {
"uuid": "a458c2aa-62e3-46b3-a262-c4e9376bbc84",
"document_id": "api-plan-radionice",
"original_name": "workshop-notes.txt",
"display_name": "Workshop notes",
"mime_type": "text/plain",
"kind": "file",
"file_size": 19,
"alt_text": "Notes for the API workshop",
"caption": "Workshop notes",
"description": "Synthetic text attachment.",
"created_at": "2026-11-06 22:48:20",
"created_by_user_id": 1,
"created_by_display_name": "Administrator",
"version_number": 1,
"version_count": 1
},
"meta": {
"request_id": "c66139e7ae63f098f839e18ac4a41d5b"
},
"links": {
"self": "/api/v1/pages/api-plan-radionice/attachments/a458c2aa-62e3-46b3-a262-c4e9376bbc84?lang=hr"
}
}
Errori verificati per questa operazione: 400, 401, 403. Consulta regole condivise per i significati dello stato e le risposte ai problemi.
GET /api/v1/pages/{documentId}/attachments/{assetUuid}/content
Scopo: trasmette un allegato dal filesystem o dal database senza racchiuderlo in JSON o base64.
Autorizzazione: attachment:read. Autorizzazioni correnti per documenti e aree di lavoro; l'accesso in lettura, modifica, pubblicazione e agli allegati viene controllato separatamente.
Percorso: documentId, assetUuid. Prendi i valori dalla risposta precedente. Un ID di pagina è la chiave del documento; nodeId è numerico e UUID non è uno slug.
Parametri di query: lang, download.
Corpo: nessun campo di input aggiuntivo; segui l'esempio.
curl --globoff --silent --show-error \
--request GET \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--dump-header response-headers.txt \
--output response.bin \
"$BASE_URL/api/v1/pages/api-plan-radionice/attachments/a458c2aa-62e3-46b3-a262-c4e9376bbc84/content?lang=hr"
Risposta effettiva: HTTP 200.
content-type: text/plain;charset=UTF-8
Il file viene salvato come response.*. Il contenuto verificato ha 19 byte; non decodificarlo come JSON.
Errori verificati per questa operazione: 401, 403. Consulta regole condivise per i significati dello stato e le risposte ai problemi.
DELETE /api/v1/pages/{documentId}/draft
Scopo: Elimina una bozza dell'area di lavoro; una nuova pagina non pubblicata viene rimossa completamente.
Autorizzazione: page:write. Autorizzazioni correnti per documenti e aree di lavoro; l'accesso in lettura, modifica, pubblicazione e agli allegati viene controllato separatamente.
Percorso: documentId. Prendi i valori dalla risposta precedente. Un ID di pagina è la chiave del documento; nodeId è numerico e UUID non è uno slug.
Parametri di query: lang.
Corpo: nessun campo di input aggiuntivo; segui l'esempio.
Prima di scrivere: ripeti la richiesta GET e imposta ETAG dalla relativa intestazione ETag.
curl --globoff --silent --show-error \
--request DELETE \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--header "If-Match: $ETAG" \
"$BASE_URL/api/v1/pages/api-plan-radionice/draft?lang=hr"
Risposta effettiva: HTTP 200.
{
"data": {
"id": "api-plan-radionice",
"title": "Plan API radionice",
"language": "hr",
"default_language": "hr",
"available_languages": [
"hr"
],
"version_number": 1,
"is_draft": false,
"draft_revision": "",
"attachment_visibility": "authenticated",
"workspace_managed": true,
"contents_visibility": "inherit",
"created_at": "2026-11-06 22:44:20",
"updated_at": "2026-11-06 22:44:20",
"created_by_user_id": 1,
"updated_by_user_id": 1,
"created_by_display_name": "Administrator",
"updated_by_display_name": "Administrator",
"html": "<h1>Plan radionice</h1>\n<p>Objasnimo cjelokupni API.</p>\n<section class=\"editor-html-task-list\" data-editor-html-task-list=\"1\" data-task-list-uuid=\"076e4a13-3797-4bdd-9fa8-618e832bffd0\" data-task-toggle-scope=\"viewers\" data-task-list-view=\"list\"><h3 class=\"editor-html-task-list-title\">Priprema radionice</h3>\n<ul class=\"editor-html-task-items\">\n<li class=\"editor-html-task-item\" data-task-uuid=\"a7586a8f-d1e7-4bb4-bcb7-2273eb82e923\" data-task-initial-completed=\"0\"><span class=\"editor-html-task-text\">Pregledati upute</span></li>\n<li class=\"editor-html-task-item\" data-task-uuid=\"fd3c4618-f8c2-4cb8-a4a4-fee47435e56b\" data-task-initial-completed=\"0\"><span class=\"editor-html-task-text\">Provjeriti primjer</span></li>\n</ul></section>",
"content": [
{
"type": "html",
"html": "<h1>Plan radionice</h1>\n<p>Objasnimo cjelokupni API.</p>\n"
},
{
"type": "task_list",
"uuid": "076e4a13-3797-4bdd-9fa8-618e832bffd0",
"title": "Priprema radionice",
"toggle_scope": "viewers",
"view": "list",
"headers": [],
"items": [
{
"uuid": "a7586a8f-d1e7-4bb4-bcb7-2273eb82e923",
"text": "Pregledati upute",
"initial_completed": false,
"cells": []
},
{
"uuid": "fd3c4618-f8c2-4cb8-a4a4-fee47435e56b",
"text": "Provjeriti primjer",
"initial_completed": false,
"cells": []
}
]
}
],
"embeds": [
{
"type": "task_list",
"uuid": "076e4a13-3797-4bdd-9fa8-618e832bffd0",
"title": "Priprema radionice",
"toggle_scope": "viewers",
"view": "list",
"headers": [],
"items": [
{
"uuid": "a7586a8f-d1e7-4bb4-bcb7-2273eb82e923",
"text": "Pregledati upute",
"initial_completed": false,
"cells": []
},
{
"uuid": "fd3c4618-f8c2-4cb8-a4a4-fee47435e56b",
"text": "Provjeriti primjer",
"initial_completed": false,
"cells": []
}
]
}
]
},
"meta": {
"request_id": "9770a689d7b973aa5573a5a5261ed09d"
},
"links": {
"self": "/api/v1/pages/api-plan-radionice/draft?lang=hr"
}
}
Errori verificati per questa operazione: 401, 403. Consulta regole condivise per i significati dello stato e le risposte ai problemi.
GET /api/v1/pages/{documentId}/draft
Scopo: Restituisce la bozza del Workspace condiviso solo a un editor autorizzato.
Autorizzazione: page:write. Autorizzazioni correnti per documenti e aree di lavoro; l'accesso in lettura, modifica, pubblicazione e agli allegati viene controllato separatamente.
Percorso: documentId. Prendi i valori dalla risposta precedente. Un ID di pagina è la chiave del documento; nodeId è numerico e UUID non è uno slug.
Parametri di query: lang.
Corpo: nessun campo di input aggiuntivo; segui l'esempio.
curl --globoff --silent --show-error \
--request GET \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
"$BASE_URL/api/v1/pages/api-plan-radionice/draft?lang=hr"
Risposta effettiva: HTTP 200.
{
"data": {
"id": "api-plan-radionice",
"title": "Plan API radionice",
"language": "hr",
"default_language": "hr",
"available_languages": [
"hr"
],
"version_number": 1,
"is_draft": true,
"draft_revision": "4665715ff5846b0194bae853acbf4c741e22c8c0f217f133",
"attachment_visibility": "none",
"workspace_managed": true,
"contents_visibility": "inherit",
"created_at": "2026-11-06 22:44:20",
"updated_at": "2026-11-06 22:44:20",
"created_by_user_id": 1,
"updated_by_user_id": 1,
"created_by_display_name": "Administrator",
"updated_by_display_name": "Administrator",
"html": "<h1>Plan radionice</h1>\n<p>Objasnimo cjelokupni API.</p>\n<section class=\"editor-html-task-list\" data-editor-html-task-list=\"1\" data-task-list-uuid=\"076e4a13-3797-4bdd-9fa8-618e832bffd0\" data-task-toggle-scope=\"viewers\" data-task-list-view=\"list\"><h3 class=\"editor-html-task-list-title\">Priprema radionice</h3>\n<ul class=\"editor-html-task-items\">\n<li class=\"editor-html-task-item\" data-task-uuid=\"a7586a8f-d1e7-4bb4-bcb7-2273eb82e923\" data-task-initial-completed=\"0\"><span class=\"editor-html-task-text\">Pregledati upute</span></li>\n<li class=\"editor-html-task-item\" data-task-uuid=\"fd3c4618-f8c2-4cb8-a4a4-fee47435e56b\" data-task-initial-completed=\"0\"><span class=\"editor-html-task-text\">Provjeriti primjer</span></li>\n</ul></section>",
"content": [
{
"type": "html",
"html": "<h1>Plan radionice</h1>\n<p>Objasnimo cjelokupni API.</p>\n"
},
{
"type": "task_list",
"uuid": "076e4a13-3797-4bdd-9fa8-618e832bffd0",
"title": "Priprema radionice",
"toggle_scope": "viewers",
"view": "list",
"headers": [],
"items": [
{
"uuid": "a7586a8f-d1e7-4bb4-bcb7-2273eb82e923",
"text": "Pregledati upute",
"initial_completed": false,
"cells": []
},
{
"uuid": "fd3c4618-f8c2-4cb8-a4a4-fee47435e56b",
"text": "Provjeriti primjer",
"initial_completed": false,
"cells": []
}
]
}
],
"embeds": [
{
"type": "task_list",
"uuid": "076e4a13-3797-4bdd-9fa8-618e832bffd0",
"title": "Priprema radionice",
"toggle_scope": "viewers",
"view": "list",
"headers": [],
"items": [
{
"uuid": "a7586a8f-d1e7-4bb4-bcb7-2273eb82e923",
"text": "Pregledati upute",
"initial_completed": false,
"cells": []
},
{
"uuid": "fd3c4618-f8c2-4cb8-a4a4-fee47435e56b",
"text": "Provjeriti primjer",
"initial_completed": false,
"cells": []
}
]
}
]
},
"meta": {
"request_id": "df48bc33363044e61d87f4e5ba3b8c01"
},
"links": {
"self": "/api/v1/pages/api-plan-radionice/draft?lang=hr"
}
}
Errori verificati per questa operazione: 401, 403. Consulta regole condivise per i significati dello stato e le risposte ai problemi.
POST /api/v1/pages/{documentId}/publish
Scopo: pubblica una bozza di Workspace esistente con un ambito e un'autorizzazione separati.
Autorizzazione: page:publish. Autorizzazioni correnti per documenti e aree di lavoro; l'accesso in lettura, modifica, pubblicazione e agli allegati viene controllato separatamente.
Percorso: documentId. Prendi i valori dalla risposta precedente. Un ID di pagina è la chiave del documento; nodeId è numerico e UUID non è uno slug.
Parametri di query: lang.
Corpo: nessun campo di input aggiuntivo; segui l'esempio.
Prima di scrivere: ripeti la richiesta GET e imposta ETAG dalla relativa intestazione ETag.
curl --globoff --silent --show-error \
--request POST \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--header "Content-Type: application/json" \
--header "If-Match: $ETAG" \
--data-raw '{}' \
"$BASE_URL/api/v1/pages/api-plan-radionice/publish?lang=hr"
Risposta effettiva: HTTP 200.
{
"data": {
"id": "api-plan-radionice",
"title": "Plan API radionice",
"language": "hr",
"default_language": "hr",
"available_languages": [
"hr"
],
"version_number": 1,
"is_draft": false,
"draft_revision": "",
"attachment_visibility": "none",
"workspace_managed": true,
"contents_visibility": "inherit",
"created_at": "2026-11-06 22:44:20",
"updated_at": "2026-11-06 22:44:21",
"created_by_user_id": 1,
"updated_by_user_id": 1,
"created_by_display_name": "Administrator",
"updated_by_display_name": "Administrator",
"html": "<h1>Plan radionice</h1>\n<p>Objasnimo cjelokupni API.</p>\n<section class=\"editor-html-task-list\" data-editor-html-task-list=\"1\" data-task-list-uuid=\"076e4a13-3797-4bdd-9fa8-618e832bffd0\" data-task-toggle-scope=\"viewers\" data-task-list-view=\"list\"><h3 class=\"editor-html-task-list-title\">Priprema radionice</h3>\n<ul class=\"editor-html-task-items\">\n<li class=\"editor-html-task-item\" data-task-uuid=\"a7586a8f-d1e7-4bb4-bcb7-2273eb82e923\" data-task-initial-completed=\"0\"><span class=\"editor-html-task-text\">Pregledati upute</span></li>\n<li class=\"editor-html-task-item\" data-task-uuid=\"fd3c4618-f8c2-4cb8-a4a4-fee47435e56b\" data-task-initial-completed=\"0\"><span class=\"editor-html-task-text\">Provjeriti primjer</span></li>\n</ul></section>",
"content": [
{
"type": "html",
"html": "<h1>Plan radionice</h1>\n<p>Objasnimo cjelokupni API.</p>\n"
},
{
"type": "task_list",
"uuid": "076e4a13-3797-4bdd-9fa8-618e832bffd0",
"title": "Priprema radionice",
"toggle_scope": "viewers",
"view": "list",
"headers": [],
"items": [
{
"uuid": "a7586a8f-d1e7-4bb4-bcb7-2273eb82e923",
"text": "Pregledati upute",
"initial_completed": false,
"cells": []
},
{
"uuid": "fd3c4618-f8c2-4cb8-a4a4-fee47435e56b",
"text": "Provjeriti primjer",
"initial_completed": false,
"cells": []
}
]
}
],
"embeds": [
{
"type": "task_list",
"uuid": "076e4a13-3797-4bdd-9fa8-618e832bffd0",
"title": "Priprema radionice",
"toggle_scope": "viewers",
"view": "list",
"headers": [],
"items": [
{
"uuid": "a7586a8f-d1e7-4bb4-bcb7-2273eb82e923",
"text": "Pregledati upute",
"initial_completed": false,
"cells": []
},
{
"uuid": "fd3c4618-f8c2-4cb8-a4a4-fee47435e56b",
"text": "Provjeriti primjer",
"initial_completed": false,
"cells": []
}
]
}
]
},
"meta": {
"request_id": "7d23703f73364a276cc886ac29334f44"
},
"links": {
"self": "/api/v1/pages/api-plan-radionice/publish?lang=hr"
}
}
Errori verificati per questa operazione: 401, 403. Consulta regole condivise per i significati dello stato e le risposte ai problemi.
POST /api/v1/pages/{documentId}/review
Scopo: invia una bozza di Workspace per la revisione e attiva le stesse notifiche condivise dell'azione web.
Autorizzazione: page:write. Autorizzazioni correnti per documenti e aree di lavoro; l'accesso in lettura, modifica, pubblicazione e agli allegati viene controllato separatamente.
Percorso: documentId. Prendi i valori dalla risposta precedente. Un ID di pagina è la chiave del documento; nodeId è numerico e UUID non è uno slug.
Parametri di query: lang.
Corpo: nessun campo di input aggiuntivo; segui l'esempio.
Prima di scrivere: ripeti la richiesta GET e imposta ETAG dalla relativa intestazione ETag.
curl --globoff --silent --show-error \
--request POST \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--header "Content-Type: application/json" \
--header "If-Match: $ETAG" \
--data-raw '{}' \
"$BASE_URL/api/v1/pages/api-plan-radionice/review?lang=hr"
Risposta effettiva: HTTP 200.
{
"data": {
"id": "api-plan-radionice",
"title": "Plan API radionice",
"language": "hr",
"default_language": "hr",
"available_languages": [
"hr"
],
"version_number": 1,
"is_draft": true,
"draft_revision": "c432b67012b68f6e9ceac28a2ab2d32233fae4f41bc6fa8c",
"attachment_visibility": "none",
"workspace_managed": true,
"contents_visibility": "inherit",
"created_at": "2026-11-06 22:44:20",
"updated_at": "2026-11-06 22:44:21",
"created_by_user_id": 1,
"updated_by_user_id": 1,
"created_by_display_name": "Administrator",
"updated_by_display_name": "Administrator",
"html": "<h1>Plan radionice</h1>\n<p>Objasnimo cjelokupni API.</p>\n<section class=\"editor-html-task-list\" data-editor-html-task-list=\"1\" data-task-list-uuid=\"076e4a13-3797-4bdd-9fa8-618e832bffd0\" data-task-toggle-scope=\"viewers\" data-task-list-view=\"list\"><h3 class=\"editor-html-task-list-title\">Priprema radionice</h3>\n<ul class=\"editor-html-task-items\">\n<li class=\"editor-html-task-item\" data-task-uuid=\"a7586a8f-d1e7-4bb4-bcb7-2273eb82e923\" data-task-initial-completed=\"0\"><span class=\"editor-html-task-text\">Pregledati upute</span></li>\n<li class=\"editor-html-task-item\" data-task-uuid=\"fd3c4618-f8c2-4cb8-a4a4-fee47435e56b\" data-task-initial-completed=\"0\"><span class=\"editor-html-task-text\">Provjeriti primjer</span></li>\n</ul></section>",
"content": [
{
"type": "html",
"html": "<h1>Plan radionice</h1>\n<p>Objasnimo cjelokupni API.</p>\n"
},
{
"type": "task_list",
"uuid": "076e4a13-3797-4bdd-9fa8-618e832bffd0",
"title": "Priprema radionice",
"toggle_scope": "viewers",
"view": "list",
"headers": [],
"items": [
{
"uuid": "a7586a8f-d1e7-4bb4-bcb7-2273eb82e923",
"text": "Pregledati upute",
"initial_completed": false,
"cells": []
},
{
"uuid": "fd3c4618-f8c2-4cb8-a4a4-fee47435e56b",
"text": "Provjeriti primjer",
"initial_completed": false,
"cells": []
}
]
}
],
"embeds": [
{
"type": "task_list",
"uuid": "076e4a13-3797-4bdd-9fa8-618e832bffd0",
"title": "Priprema radionice",
"toggle_scope": "viewers",
"view": "list",
"headers": [],
"items": [
{
"uuid": "a7586a8f-d1e7-4bb4-bcb7-2273eb82e923",
"text": "Pregledati upute",
"initial_completed": false,
"cells": []
},
{
"uuid": "fd3c4618-f8c2-4cb8-a4a4-fee47435e56b",
"text": "Provjeriti primjer",
"initial_completed": false,
"cells": []
}
]
}
]
},
"meta": {
"request_id": "6055daf88d087163b68b70f753b715c5"
},
"links": {
"self": "/api/v1/pages/api-plan-radionice/review?lang=hr"
}
}
Errori verificati per questa operazione: 401, 403. Consulta regole condivise per i significati dello stato e le risposte ai problemi.
POST /api/v1/pages/{documentId}/translations
Scopo: copia il contenuto da una lingua in una bozza di lingua nuova o esistente.
Autorizzazione: page:write. Autorizzazioni correnti per documenti e aree di lavoro; l'accesso in lettura, modifica, pubblicazione e agli allegati viene controllato separatamente.
Percorso: documentId. Prendi i valori dalla risposta precedente. Un ID di pagina è la chiave del documento; nodeId è numerico e UUID non è uno slug.
Parametri di query: nessuno.
Corpo/campi supportati: source_language, target_language. L'esempio seguente utilizza valori verificati; le condizioni e le regole di sostituzione delle liste sono descritte all'inizio del capitolo.
curl --globoff --silent --show-error \
--request POST \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--header "Content-Type: application/json" \
--data-raw '{
"source_language": "hr",
"target_language": "en"
}' \
"$BASE_URL/api/v1/pages/api-plan-radionice/translations"
Risposta effettiva: HTTP 201.
{
"data": {
"id": "api-plan-radionice",
"title": "Plan API radionice",
"language": "en",
"default_language": "hr",
"available_languages": [
"en",
"hr"
],
"version_number": 2,
"is_draft": true,
"draft_revision": "c6a39528ef34103cce565e170d10405246f491b2f09dbf0e",
"attachment_visibility": "authenticated",
"workspace_managed": true,
"contents_visibility": "inherit",
"created_at": "2026-11-06 22:44:20",
"updated_at": "2026-11-06 22:49:03",
"created_by_user_id": 1,
"updated_by_user_id": 1,
"created_by_display_name": "Administrator",
"updated_by_display_name": "Administrator",
"html": "<h1>Plan radionice</h1>\n<p>Objasnimo cjelokupni API.</p>\n<section class=\"editor-html-task-list\" data-editor-html-task-list=\"1\" data-task-list-uuid=\"076e4a13-3797-4bdd-9fa8-618e832bffd0\" data-task-toggle-scope=\"viewers\" data-task-list-view=\"list\"><h3 class=\"editor-html-task-list-title\">Priprema radionice</h3>\n<ul class=\"editor-html-task-items\">\n<li class=\"editor-html-task-item\" data-task-uuid=\"a7586a8f-d1e7-4bb4-bcb7-2273eb82e923\" data-task-initial-completed=\"0\"><span class=\"editor-html-task-text\">Pregledati upute</span></li>\n<li class=\"editor-html-task-item\" data-task-uuid=\"fd3c4618-f8c2-4cb8-a4a4-fee47435e56b\" data-task-initial-completed=\"0\"><span class=\"editor-html-task-text\">Provjeriti primjer</span></li>\n</ul></section>",
"content": [
{
"type": "html",
"html": "<h1>Plan radionice</h1>\n<p>Objasnimo cjelokupni API.</p>\n"
},
{
"type": "task_list",
"uuid": "076e4a13-3797-4bdd-9fa8-618e832bffd0",
"title": "Priprema radionice",
"toggle_scope": "viewers",
"view": "list",
"headers": [],
"items": [
{
"uuid": "a7586a8f-d1e7-4bb4-bcb7-2273eb82e923",
"text": "Pregledati upute",
"initial_completed": false,
"cells": []
},
{
"uuid": "fd3c4618-f8c2-4cb8-a4a4-fee47435e56b",
"text": "Provjeriti primjer",
"initial_completed": false,
"cells": []
}
]
}
],
"embeds": [
{
"type": "task_list",
"uuid": "076e4a13-3797-4bdd-9fa8-618e832bffd0",
"title": "Priprema radionice",
"toggle_scope": "viewers",
"view": "list",
"headers": [],
"items": [
{
"uuid": "a7586a8f-d1e7-4bb4-bcb7-2273eb82e923",
"text": "Pregledati upute",
"initial_completed": false,
"cells": []
},
{
"uuid": "fd3c4618-f8c2-4cb8-a4a4-fee47435e56b",
"text": "Provjeriti primjer",
"initial_completed": false,
"cells": []
}
]
}
]
},
"meta": {
"request_id": "84a86dd54d71f443a53be6d642205db5"
},
"links": {
"self": "/api/v1/pages/api-plan-radionice/translations"
}
}
Errori verificati per questa operazione: 401, 403. Consulta regole condivise per i significati dello stato e le risposte ai problemi.
GET /api/v1/pages/{documentId}/versions
Scopo: restituisce soltanto la cronologia pubblicata per la lingua richiesta.
Autorizzazione: page:read. Autorizzazioni correnti per documenti e aree di lavoro; l'accesso in lettura, modifica, pubblicazione e agli allegati viene controllato separatamente.
Percorso: documentId. Prendi i valori dalla risposta precedente. Un ID di pagina è la chiave del documento; nodeId è numerico e UUID non è uno slug.
Parametri di query: lang, page[after], page[limit].
Corpo: nessun campo di input aggiuntivo; segui l'esempio.
curl --globoff --silent --show-error \
--request GET \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
"$BASE_URL/api/v1/pages/api-plan-radionice/versions?lang=hr"
Risposta effettiva: HTTP 200.
{
"data": [
{
"document_id": "api-plan-radionice",
"language": "hr",
"version_number": 1,
"title": "Plan API radionice",
"created_at": "2026-11-06 22:44:20",
"created_by_user_id": 1,
"created_by_display_name": "Administrator",
"is_current": true
}
],
"meta": {
"request_id": "0bc76919135a6179e8157de9435a1cf2",
"page": {
"limit": 50,
"total": 1,
"has_more": false,
"next_cursor": null
}
},
"links": {
"self": "/api/v1/pages/api-plan-radionice/versions?lang=hr",
"next": null
}
}
Errori verificati per questa operazione: 401, 403. Consulta regole condivise per i significati dello stato e le risposte ai problemi.
GET /api/v1/pages/{documentId}/versions/{versionNumber}
Scopo: Restituisce un'esatta versione pubblicata.
Autorizzazione: page:read. Autorizzazioni correnti per documenti e aree di lavoro; l'accesso in lettura, modifica, pubblicazione e agli allegati viene controllato separatamente.
Percorso: documentId, versionNumber. Prendi i valori dalla risposta precedente. Un ID di pagina è la chiave del documento; nodeId è numerico e UUID non è uno slug.
Parametri di query: lang.
Corpo: nessun campo di input aggiuntivo; segui l'esempio.
curl --globoff --silent --show-error \
--request GET \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
"$BASE_URL/api/v1/pages/api-plan-radionice/versions/1?lang=hr"
Risposta effettiva: HTTP 200.
{
"data": {
"document_id": "api-plan-radionice",
"language": "hr",
"version_number": 1,
"title": "Plan API radionice",
"created_at": "2026-11-06 22:44:20",
"created_by_user_id": 1,
"created_by_display_name": "Administrator",
"is_current": true,
"html": "<h1>Plan radionice</h1>\n<p>Objasnimo cjelokupni API.</p>\n<section class=\"editor-html-task-list\" data-editor-html-task-list=\"1\" data-task-list-uuid=\"076e4a13-3797-4bdd-9fa8-618e832bffd0\" data-task-toggle-scope=\"viewers\" data-task-list-view=\"list\"><h3 class=\"editor-html-task-list-title\">Priprema radionice</h3>\n<ul class=\"editor-html-task-items\">\n<li class=\"editor-html-task-item\" data-task-uuid=\"a7586a8f-d1e7-4bb4-bcb7-2273eb82e923\" data-task-initial-completed=\"0\"><span class=\"editor-html-task-text\">Pregledati upute</span></li>\n<li class=\"editor-html-task-item\" data-task-uuid=\"fd3c4618-f8c2-4cb8-a4a4-fee47435e56b\" data-task-initial-completed=\"0\"><span class=\"editor-html-task-text\">Provjeriti primjer</span></li>\n</ul></section>",
"content": [
{
"type": "html",
"html": "<h1>Plan radionice</h1>\n<p>Objasnimo cjelokupni API.</p>\n"
},
{
"type": "task_list",
"uuid": "076e4a13-3797-4bdd-9fa8-618e832bffd0",
"title": "Priprema radionice",
"toggle_scope": "viewers",
"view": "list",
"headers": [],
"items": [
{
"uuid": "a7586a8f-d1e7-4bb4-bcb7-2273eb82e923",
"text": "Pregledati upute",
"initial_completed": false,
"cells": []
},
{
"uuid": "fd3c4618-f8c2-4cb8-a4a4-fee47435e56b",
"text": "Provjeriti primjer",
"initial_completed": false,
"cells": []
}
]
}
],
"embeds": [
{
"type": "task_list",
"uuid": "076e4a13-3797-4bdd-9fa8-618e832bffd0",
"title": "Priprema radionice",
"toggle_scope": "viewers",
"view": "list",
"headers": [],
"items": [
{
"uuid": "a7586a8f-d1e7-4bb4-bcb7-2273eb82e923",
"text": "Pregledati upute",
"initial_completed": false,
"cells": []
},
{
"uuid": "fd3c4618-f8c2-4cb8-a4a4-fee47435e56b",
"text": "Provjeriti primjer",
"initial_completed": false,
"cells": []
}
]
}
]
},
"meta": {
"request_id": "f6945104df1b1d6d84aa0bed258ca2ea"
},
"links": {
"self": "/api/v1/pages/api-plan-radionice/versions/1?lang=hr"
}
}
Errori verificati per questa operazione: 401, 403. Consulta regole condivise per i significati dello stato e le risposte ai problemi.
POST /api/v1/pages/{documentId}/versions/{versionNumber}/restore
Scopo: Ripristina una vecchia versione come nuova versione funzionante o bozza di Workspace.
Autorizzazione: page:write. Autorizzazioni correnti per documenti e aree di lavoro; l'accesso in lettura, modifica, pubblicazione e agli allegati viene controllato separatamente.
Percorso: documentId, versionNumber. Prendi i valori dalla risposta precedente. Un ID di pagina è la chiave del documento; nodeId è numerico e UUID non è uno slug.
Parametri di query: lang.
Corpo: nessun campo di input aggiuntivo; segui l'esempio.
curl --globoff --silent --show-error \
--request POST \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--header "Content-Type: application/json" \
--data-raw '{}' \
"$BASE_URL/api/v1/pages/api-plan-radionice/versions/1/restore?lang=hr"
Risposta effettiva: HTTP 200.
{
"data": {
"id": "api-plan-radionice",
"title": "Plan API radionice",
"language": "hr",
"default_language": "hr",
"available_languages": [
"hr"
],
"version_number": 2,
"is_draft": true,
"draft_revision": "630dbf45a41dbf230ff2010a88a5552309f73a82d6ead401",
"attachment_visibility": "none",
"workspace_managed": true,
"contents_visibility": "inherit",
"created_at": "2026-11-06 22:44:20",
"updated_at": "2026-11-06 22:48:20",
"created_by_user_id": 1,
"updated_by_user_id": 1,
"created_by_display_name": "Administrator",
"updated_by_display_name": "Administrator",
"html": "<h1>Plan radionice</h1>\n<p>Objasnimo cjelokupni API.</p>\n<section class=\"editor-html-task-list\" data-editor-html-task-list=\"1\" data-task-list-uuid=\"076e4a13-3797-4bdd-9fa8-618e832bffd0\" data-task-toggle-scope=\"viewers\" data-task-list-view=\"list\"><h3 class=\"editor-html-task-list-title\">Priprema radionice</h3>\n<ul class=\"editor-html-task-items\">\n<li class=\"editor-html-task-item\" data-task-uuid=\"a7586a8f-d1e7-4bb4-bcb7-2273eb82e923\" data-task-initial-completed=\"0\"><span class=\"editor-html-task-text\">Pregledati upute</span></li>\n<li class=\"editor-html-task-item\" data-task-uuid=\"fd3c4618-f8c2-4cb8-a4a4-fee47435e56b\" data-task-initial-completed=\"0\"><span class=\"editor-html-task-text\">Provjeriti primjer</span></li>\n</ul></section>",
"content": [
{
"type": "html",
"html": "<h1>Plan radionice</h1>\n<p>Objasnimo cjelokupni API.</p>\n"
},
{
"type": "task_list",
"uuid": "076e4a13-3797-4bdd-9fa8-618e832bffd0",
"title": "Priprema radionice",
"toggle_scope": "viewers",
"view": "list",
"headers": [],
"items": [
{
"uuid": "a7586a8f-d1e7-4bb4-bcb7-2273eb82e923",
"text": "Pregledati upute",
"initial_completed": false,
"cells": []
},
{
"uuid": "fd3c4618-f8c2-4cb8-a4a4-fee47435e56b",
"text": "Provjeriti primjer",
"initial_completed": false,
"cells": []
}
]
}
],
"embeds": [
{
"type": "task_list",
"uuid": "076e4a13-3797-4bdd-9fa8-618e832bffd0",
"title": "Priprema radionice",
"toggle_scope": "viewers",
"view": "list",
"headers": [],
"items": [
{
"uuid": "a7586a8f-d1e7-4bb4-bcb7-2273eb82e923",
"text": "Pregledati upute",
"initial_completed": false,
"cells": []
},
{
"uuid": "fd3c4618-f8c2-4cb8-a4a4-fee47435e56b",
"text": "Provjeriti primjer",
"initial_completed": false,
"cells": []
}
]
}
]
},
"meta": {
"request_id": "bdcd34ef05619d5d30396f479ad63b15"
},
"links": {
"self": "/api/v1/pages/api-plan-radionice/versions/1/restore?lang=hr"
}
}
Errori verificati per questa operazione: 401, 403. Consulta regole condivise per i significati dello stato e le risposte ai problemi.
Esempio di caricamento completo in due parti
Entrambi i blocchi utilizzano lo stesso upload_id, nome file e dimensione totale. Utilizza un altro identificatore per un altro caricamento. Ogni blocco in questo esempio verificato ha 6 byte, 12 in totale. Per prima cosa crea i file nella directory corrente:
printf 'first-' > guide-chunk-0.part
printf 'second' > guide-chunk-1.part
curl --globoff --silent --show-error \
--request POST \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--form upload_id=guide-5f4c81d11960 \
--form original_name=guide-notes.txt \
--form mime_type=text/plain \
--form file_size=12 \
--form chunk_index=0 \
--form chunk_count=2 \
--form 'attachment=@./guide-chunk-0.part;type=application/octet-stream' \
"$BASE_URL/api/v1/pages/api-vodic-za-integracije/attachments/chunks?lang=hr"
Risposta effettiva: HTTP 202.
{
"data": null,
"meta": {
"request_id": "cce2fe88fd89a2f16ac13e4498955357"
},
"links": {
"self": "/api/v1/pages/api-vodic-za-integracije/attachments/chunks?lang=hr"
}
}
curl --globoff --silent --show-error \
--request POST \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--form upload_id=guide-5f4c81d11960 \
--form original_name=guide-notes.txt \
--form mime_type=text/plain \
--form file_size=12 \
--form chunk_index=1 \
--form chunk_count=2 \
--form 'attachment=@./guide-chunk-1.part;type=application/octet-stream' \
"$BASE_URL/api/v1/pages/api-vodic-za-integracije/attachments/chunks?lang=hr"
Risposta effettiva: HTTP 201.
{
"data": {
"uuid": "f2f91dda-c922-45c9-b70a-1e7ad675399f",
"document_id": "api-vodic-za-integracije",
"original_name": "guide-notes.txt",
"display_name": "guide-notes.txt",
"mime_type": "text/plain",
"kind": "file",
"file_size": 12,
"alt_text": "",
"caption": "guide-notes.txt",
"description": "",
"created_at": "2026-11-06 23:56:28",
"created_by_user_id": 1,
"created_by_display_name": "Administrator",
"version_number": 1,
"version_count": 1
},
"meta": {
"request_id": "3c6b285b281884e99cf54de1b44d0898"
},
"links": {
"self": "/api/v1/pages/api-vodic-za-integracije/attachments/chunks?lang=hr"
}
}
Comments
0There are no comments yet.
You must sign in to add a comment.