POST /reports/$REPORT_ID

This is used to request the generation of a periodic report. It is used internally by the taler-merchant-report-generator. The endpoint itself is unauthenticated, but the report-token serves to authorize the request.

Request:

The request must be a ReportGenerationRequest.

Response:

200 OK:

The backend has successfully added a new report. Details returned (including the content type) depend fully on the type of report that was requested.

400 Bad request:

Malformed JSON or missing fields. Returned with TALER_EC_GENERIC_PARAMETER_MALFORMED.

404 Not found:

The report ID or the report token are unknown. Returned with TALER_EC_MERCHANT_GENERIC_REPORT_UNKNOWN.

413 Request entity too large:

The uploaded body is to long, it exceeds the size limit. Returned with an error code of TALER_EC_GENERIC_UPLOAD_EXCEEDS_LIMIT.

500 Internal Server Error:

The server experienced an internal failure. Returned with TALER_EC_GENERIC_DB_FETCH_FAILED.

Details:

interface ReportGenerationRequest {

  // Report token authorizing the report generation.
  report_token: ShortHashCode;

}