diff options
author | Florian Dold <florian.dold@gmail.com> | 2019-09-27 00:55:41 +0200 |
---|---|---|
committer | Florian Dold <florian.dold@gmail.com> | 2019-09-27 00:55:41 +0200 |
commit | 3df802c19af277bcf46586909de2cbb41f34b962 (patch) | |
tree | f82f23e54c44715e3f640c523f3f396023c7b2ea /core/api-auditor.rst | |
parent | 8bfd85f7c50ffad565e8111891eb61a47cc6f969 (diff) | |
download | docs-3df802c19af277bcf46586909de2cbb41f34b962.tar.gz docs-3df802c19af277bcf46586909de2cbb41f34b962.tar.bz2 docs-3df802c19af277bcf46586909de2cbb41f34b962.zip |
The big doc refactoring
Use new ts:def directive for TypeScript definitions and use ``foo`` for
literal text. The form `foo` is an interpreted role. Also, only use
the interpreted role form for references in TS definition comments.
Diffstat (limited to 'core/api-auditor.rst')
-rw-r--r-- | core/api-auditor.rst | 28 |
1 files changed, 11 insertions, 17 deletions
diff --git a/core/api-auditor.rst b/core/api-auditor.rst index 957b1c01..03a26f73 100644 --- a/core/api-auditor.rst +++ b/core/api-auditor.rst @@ -21,7 +21,7 @@ The Auditor RESTful JSON API The API specified here follows the :ref:`general conventions <http-common>` for all details not specified in the individual requests. -The `glossary <https://docs.taler.net/glossary.html#glossary>` +The `glossary <https://docs.taler.net/glossary.html#glossary>`_ defines all specific terms used in this section. .. _auditor-version: @@ -54,10 +54,10 @@ know-your-customer (KYC) registration before issuing contracts. // https://www.gnu.org/software/libtool/manual/html_node/Versioning.html#Versioning // The format is "current:revision:age". Note that the auditor // protocol is versioned independently of the exchange's protocol. - version: String; + version: string; // Return which currency this auditor is auditing for. - currency: String; + currency: string; // EdDSA master public key of the auditor auditor_public_key: EddsaPublicKey; @@ -86,21 +86,19 @@ know-your-customer (KYC) registration before issuing contracts. **Response:** :status 200 OK: - The auditor responds with a `ExchangeList`_ object. This request should + The auditor responds with a :ts:type:`ExchangeList` object. This request should virtually always be successful. **Details:** - .. _ExchangeList: - .. code-block:: tsref + .. ts:def:: ExchangeList interface ExchangeList { // Exchanges audited by this auditor exchanges: ExchangeEntry[]; } - .. _tsref-type-Denom: - .. code-block:: tsref + .. ts:def:: ExchangeEntry interface ExchangeEntry { @@ -134,28 +132,24 @@ paid out first. .. http:put:: /deposit-confirmation - Submits a `DepositConfirmation`_ to the exchange. Should succeed + Submits a `DepositConfirmation` to the exchange. Should succeed unless the signature provided is invalid or the exchange is not audited by this auditor. **Response:** - :status 200: The auditor responds with a `DepositAudited`_ object. + :status 200: The auditor responds with a `DepositAudited` object. This request should virtually always be successful. **Details:** - .. _DepositAudited: - .. _tsref-type-DepositAudited: - .. code-block:: tsref + .. ts:def:: DepositAudited interface DepositAudited { - // TODO: do we care for the auditor to sign this? + // TODO: do we care for the auditor to sign this? } - .. _DepositConfirmation: - .. _tsref-type-DepositConfirmation: - .. code-block:: tsref + .. ts:def:: DepositConfirmation interface DepositConfirmation { |