swagger: '2.0'
info:
  version: '1.0.0-beta'
  title: Revision timeline
  description: Indexing of revision IDs by time
  termsofservice: https://github.com/wikimedia/restbase#restbase
  contact:
    name: Services
    email: services@lists.wikimedia.org
    url: https://www.mediawiki.org/wiki/Services
  license:
    name: Apache licence, v2
    url: https://www.apache.org/licenses/LICENSE-2.0
paths:
  /timeline/{domain}/{tid}/{rev}:
    get:
      summary: Store a new timeline entry
      produces:
        - application/json; charset=utf-8; profile="https://www.mediawiki.org/wiki/Specs/Summary/1.1.2"
      parameters:
        - name: domain
          in: path
          type: string
          required: true
        - name: tid
          in: path
          type: string
          required: true
        - name: rev
          in: path
          type: string
          required: true
      x-setup-handler:
        # Set up a simple key-value bucket.
        - init:
            method: 'put'
            uri: /{domain}/sys/key_value/timeline
            body:
              valueType: 'int'

      x-request-handler:
        - store_and_return:
            request:
              method: put
              uri: /{domain}/sys/key_value/timeline/{request.params.domain}/{request.params.tid}
              body: '{{ request.params.rev }}'
            return_if:
              status: 204
            return:
              status: 200
              headers:
                content-type: '{{store_and_return.headers.content-type}}'
                etag: '{{store_and_return.headers.etag}}'
              body: '{{store_and_return.body}}'