Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 12 additions & 2 deletions developer_manual/api/external-email-signers.rst
Original file line number Diff line number Diff line change
Expand Up @@ -47,20 +47,30 @@ branch (not in another release's source):

* `Bash client (flow.sh) <https://github.com/LibreSign/documentation/blob/stable14/examples/external-email-signers/flow.sh>`_
* `PHP client (flow.php) <https://github.com/LibreSign/documentation/blob/stable14/examples/external-email-signers/flow.php>`_
* `LibreSign 14 fixture (request-14.json) <https://github.com/LibreSign/documentation/blob/stable14/examples/external-email-signers/request-main.json>`_
* `LibreSign 14 fixture (request-14.json) <https://github.com/LibreSign/documentation/blob/stable14/examples/external-email-signers/request-14.json>`_

Clone the **matching documentation branch**, then work in the examples
directory (Git required):

.. code-block:: bash

git clone --depth 1 --branch main https://github.com/LibreSign/documentation.git
git clone --depth 1 --branch stable14 https://github.com/LibreSign/documentation.git
cd documentation/examples/external-email-signers

Keep the clients and their ``request-*.json`` fixtures together. Consult this
release's :doc:`openapi` and its pinned `OpenAPI JSON <openapi.json>`_ when
adapting the request to a real integration.

For a ready-to-import n8n workflow, see the `shared LibreSign + n8n guide
<https://github.com/LibreSign/documentation/blob/560861b9ac0c4673cac490aaf8de226d227fa792/examples/n8n/README.md>`_. It uses a single external signer, explicit invitation,
bounded OCS polling and an authorized WebDAV download. Select this
LibreSign release in the workflow configuration: versions 13/14 use
``mandatory: 1``; versions 15/development use
``requirement: "required"``. Native completion events belong to the
development documentation and are not required by the polling workflow.
The n8n files are maintained on the development branch; do not replace
the release-specific cURL/PHP fixtures with development payloads.

.. include:: _external-email-signers-release.inc

The scripts POST /request-signature,
Expand Down
6 changes: 6 additions & 0 deletions developer_manual/integration/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -83,6 +83,12 @@ Read the relevant guide
integration with fixture selection and authorized PDF retrieval.
- :doc:`../api/openapi` — the **actual API schema for this release**, including
required properties and supported responses.
- `n8n importable signing workflow <https://github.com/LibreSign/documentation/blob/560861b9ac0c4673cac490aaf8de226d227fa792/examples/n8n/README.md>`_ — one external email
signer, App Password authentication, bounded OCS polling and authorized
WebDAV retrieval. The shared example selects the request schema for
LibreSign 13/14 (``mandatory``) or 15/development (``requirement``).
Native completion events are documented only for development; the
importable workflow uses polling on every supported release.

Contract and ownership boundaries
---------------------------------
Expand Down
Loading