taler-docs

Documentation for GNU Taler components, APIs and protocols
Log | Files | Refs | README | LICENSE

get-private-reports.rst (1241B)

      1 .. http:get:: [/instances/$INSTANCES]/private/reports
      2 
      3   This is used to return all the scheduled reports
      4   that are present in our backend.
      5 
      6   **Required permission:** ``reports-read``
      7 
      8   **Request:**
      9 
     10   :query limit: *Optional.*
     11     At most return the given number of results. Negative for descending by ``serial``, positive for ascending by ``serial``. Defaults to ``-20``.
     12   :query offset: *Optional.*
     13     Starting ``serial`` for :ref:`pagination <row-id-pagination>`.
     14 
     15   **Response:**
     16 
     17   :http:statuscode:`200 OK`:
     18     The backend has successfully returned all the reports.
     19     Returns a `ReportsSummaryResponse`.
     20 
     21   :http:statuscode:`404 Not found`:
     22     The backend has does not know about the instance.
     23 
     24   **Details:**
     25 
     26   .. ts:def:: ReportsSummaryResponse
     27 
     28     interface ReportsSummaryResponse {
     29 
     30       // Return reports that are present in our backend.
     31       reports: ReportEntry[];
     32 
     33     }
     34 
     35   The `ReportEntry` object describes a report.
     36   It has the following structure:
     37 
     38   .. ts:def:: ReportEntry
     39 
     40     interface ReportEntry {
     41 
     42       // Report identifier
     43       report_serial: Integer;
     44 
     45       // Description for the report.
     46       description: string;
     47 
     48       // Frequency for the report.
     49       report_frequency: RelativeTime;
     50 
     51     }