Инструменты пользователя

Инструменты сайта


sharixopen:knowledge:standards:page_lifecycle

Жизненный цикл страницы: создание, обновление, перенос, удаление

Статус: проект для рассмотрения · Область: ShariX Open

Раздел · Методология и навигация

Содержание

Постоянный адрес страницы не содержит номера редакции, если речь не о одновременно поддерживаемых версиях API. История текста хранится в самой DokuWiki.

Новая страница: `upsert` и новый уникальный `id`/`page`.

Исправление содержимого: `upsert` с прежними `id`/`page`, новым SHA-256 текста и актуальным `base_sha256`.

Переименование URL: не заменяется одним `previous_id`. Нужен отдельный подтверждённый перенос содержимого и связей с последующим удалением старого адреса.

Удаление: только `operation=delete`, пустой файл, точный `delete_confirmation`, актуальный `base_sha256` и право Delete (16) технической учётной записи. Пустая обычная страница не считается командой удаления.

Перед публикацией проверяют действие на каждом документе и после публикации сверяют фактический результат. При конфликте хеша нельзя переписывать вручную изменённую страницу наугад.

Связанные материалы

sharixopen/knowledge/standards/page_lifecycle.txt · Последнее изменение: — sx_knowledge_api_open

© 2022 ShariX