diff --git a/docs/source/interface.rst b/docs/source/interface.rst index 6af824a43fdf53c1eabd40e2190d21923ceefb77..b824acdef68269d41bfab68c7d6bdd69af33e658 100644 --- a/docs/source/interface.rst +++ b/docs/source/interface.rst @@ -49,19 +49,19 @@ The response is **OK** with ``application/json`` content-type response body like The elements of the list are objects like the one returned by issuing a **GET** to a child of this collection resource. -``GET /storage-plugins/privatestorageio/zkapauthz-v1/blinded-token`` +``GET /storage-plugins/privatestorageio/zkapauthz-v1/unblinded-token`` ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -This endpoint allows an external agent to retrieve unused blinded tokens present in the node's database. -Blinded tokens are returned in ascending text sorted order. +This endpoint allows an external agent to retrieve unused unblinded tokens present in the node's database. +Unblinded tokens are returned in ascending text sorted order. This endpoint accepts several query arguments: - * limit: An integer limiting the number of blinded tokens to retrieve. - * position: A string which can be compared against blinded token values. - Only blinded tokens which sort as great than this value are returned. + * limit: An integer limiting the number of unblinded tokens to retrieve. + * position: A string which can be compared against unblinded token values. + Only unblinded tokens which sort as great than this value are returned. This endpoint accepts no request body. The response is **OK** with ``application/json`` content-type response body like:: - {"total": <integer>, "blinded-tokens": [<blinded token string>, ...]} + {"total": <integer>, "unblinded-tokens": [<unblinded token string>, ...]}