List report files

Returns one entry for each UTC day in [start_date, end_date] that has a file, in date order, each with a signed GET link to that day's file. A day with no transactions still has a file, with no rows. A day with no entry is a day the export has not written yet, such as the current UTC day or a day whose export is late; it does not mean the day had no transactions, so call again later for that day. Days before first_date never get a file, because the shop's export of that type and format started on first_date. A shop that has no file of the requested type and format on any day gets FAILED_PRECONDITION instead. Stash turns a shop's export on, and it writes the first file, before the partner is told that the report is available; so this error means the report is not available for the shop yet: do not retry, contact Stash. The files use the same columns as the transaction reports in Stash Studio. Each row is one event: a payment, a refund or a dispute step. A later refund or dispute step is a new row on its own day; it does not change the payment's row. The record_id column is a stable ID of the event: the same event has the same record_id in every file. Use it to remove rows that two pulls share, and keep the row from the later pull. Columns are added only at the end, and a column is renamed or removed only with advance notice, so read the files by column name, not by position. A SETTLED day that is not final can still change; pull it again until is_final is true. SETTLED days become final together with their UTC calendar month, when Stash closes the month, usually 1 to 5 days after it ends. CHARGE days are never final, because their rows change while their charges settle, so do not wait for is_final on a CHARGE day. Stash gives no stop signal for a CHARGE day: follow it for as long as you need its unsettled rows, and use SETTLED for figures that become final. To know when to download a day again, compare its content_hash with the copy you hold: every change to the file's bytes gives a new content_hash, and the same bytes always give the same content_hash. as_of is the time of the data snapshot that each file was written from. Every link is valid until download_url_expires_at, 15 minutes after the response; call again for fresh links. This method accepts only the versioned x-stash-hmac-signature header, signed over the request body exactly as sent; the legacy stash-hmac-signature header is rejected with HTTP 401 (UNAUTHENTICATED), because it carries no timestamp and a captured request could be replayed. The shop in the signature header must equal the shop_id in the path. Repeated calls are safe, so retry after UNAVAILABLE or a timeout with a fresh timestamp and signature. Returns HTTP 401 (UNAUTHENTICATED) when the signature is missing, invalid, outside the time window, sent in the legacy header, or names a different shop or one Stash does not know; HTTP 400 (INVALID_ARGUMENT) when report_type or report_format is unspecified or unknown, a date is missing or is not YYYY-MM-DD, end_date is before start_date, or the range is longer than 31 days; HTTP 400 (FAILED_PRECONDITION) when the shop has no file of the requested type and format on any day; and HTTP 503 (UNAVAILABLE) when the files could not be listed, in which case retry. The two HTTP 400 cases differ only by the code in the response body: 3 for INVALID_ARGUMENT, 9 for FAILED_PRECONDITION. Do not retry UNAUTHENTICATED or INVALID_ARGUMENT unchanged: correct the signature or the request first, then send it again with a fresh timestamp and signature.

curl -X POST "https://example.com/sdk/studio/string/reports/files" \  -H "Content-Type: application/json" \  -d '{    "reportType": "REPORT_TYPE_UNSPECIFIED",    "reportFormat": "REPORT_FORMAT_UNSPECIFIED",    "startDate": "string",    "endDate": "string"  }'

{  "files": [    {      "date": "string",      "isFinal": true,      "sizeBytes": "string",      "downloadUrl": "string",      "asOf": "2019-08-24T14:15:22Z",      "contentHash": "string"    }  ],  "downloadUrlExpiresAt": "2019-08-24T14:15:22Z",  "firstDate": "string"}