[6/N] [List API] docs(service): document gateway List API read model

[albertywu]

Summary

Adds the SubmitQueue Gateway List API to the service README API reference and includes a grpcurl example for listing recent requests by queue and time window.

Test Plan

1. Start up server, issue a Land Request using:

grpcurl -plaintext -import-path . -proto api/submitqueue/gateway/proto/gateway.proto -d '{"queue":"test-queue","change":{"uris":["github://uber/docs-list/pull/2/abcdef0123456789abcdef0123456789abcdef02"]},"strategy":"REBASE"}' localhost:64687 uber.submitqueue.gateway.SubmitQueueGateway/Land

STDOUT:

{
  "sqid": "test-queue/1"
}

2. Issue a List API request:

grpcurl -plaintext -import-path . -proto api/submitqueue/gateway/proto/gateway.proto -d '{"queue":"test-queue","start_time_ms":1,"end_time_ms":9999999999999,"page_size":10}' localhost:64687 uber.submitqueue.gateway.SubmitQueueGateway/List

STDOUT:

{
  "requests": [
    {
      "sqid": "test-queue/1",
      "queue": "test-queue",
      "changeUris": [
        "github://uber/docs-list/pull/2/abcdef0123456789abcdef0123456789abcdef02"
      ],
      "status": "landed",
      "metadata": {
        "batch_id": "test-queue/batch/1"
      },
      "startedAtMs": "1783389642136",
      "updatedAtMs": "1783389644505",
      "completedAtMs": "1783389644505",
      "terminal": true
    }
  ]
}

Issues

Stack

1. [1/N] [List API] docs(list): define request context read model #310
2. [2/N] [List API] feat(context): add immutable request admission store #302
3. [3/N] [List API] feat(summary): project request logs from admission context #303
4. [4/N] [List API] feat(gateway): expose List API from request summaries #304
5. [5/N] [List API] test(e2e): cover gateway List API #305
6. @ [6/N] [List API] docs(service): document gateway List API read model #306