Last change
on this file since 479 was 463, checked in by alloc, 15 months ago |
21.1.16.0 release
Completed OpenAPI specs
Add support to path handlers to register OpenAPI specs
Fixed ItemIconHandler throwing error when requested path contains no dot
|
File size:
1.6 KB
|
Rev | Line | |
---|
[463] | 1 | openapi: 3.1.0
|
---|
| 2 | info:
|
---|
| 3 | title: MapTileHandler
|
---|
| 4 | version: '1'
|
---|
| 5 |
|
---|
| 6 | components:
|
---|
| 7 | parameters:
|
---|
| 8 | ZoomLevelParameter:
|
---|
| 9 | name: zoom
|
---|
| 10 | in: path
|
---|
| 11 | required: true
|
---|
| 12 | schema:
|
---|
| 13 | type: integer
|
---|
| 14 | minimum: 0
|
---|
| 15 | description: Zoom level, 0 being most zoomed out
|
---|
| 16 |
|
---|
| 17 | CoordXParameter:
|
---|
| 18 | name: x
|
---|
| 19 | in: path
|
---|
| 20 | required: true
|
---|
| 21 | schema:
|
---|
| 22 | type: integer
|
---|
| 23 | description: X (east/west) index of the tile
|
---|
| 24 |
|
---|
| 25 | CoordYParameter:
|
---|
| 26 | name: y
|
---|
| 27 | in: path
|
---|
| 28 | required: true
|
---|
| 29 | schema:
|
---|
| 30 | type: integer
|
---|
| 31 | description: Y (north/south) index of the tile
|
---|
| 32 |
|
---|
| 33 |
|
---|
| 34 | paths:
|
---|
| 35 | /BASEPATH/{zoom}/{x}/{y}.png:
|
---|
| 36 | get:
|
---|
| 37 | tags:
|
---|
| 38 | - Map
|
---|
| 39 | summary: MapTile get
|
---|
| 40 | description: Get a map tile for the given zoom level and tile indexes
|
---|
| 41 | operationId: MapTileHandler.get.name
|
---|
| 42 | parameters:
|
---|
| 43 | - $ref: '#/components/parameters/ZoomLevelParameter'
|
---|
| 44 | - $ref: '#/components/parameters/CoordXParameter'
|
---|
| 45 | - $ref: '#/components/parameters/CoordYParameter'
|
---|
| 46 | responses:
|
---|
| 47 | 200:
|
---|
| 48 | description: Map tile
|
---|
| 49 | content:
|
---|
| 50 | image/png:
|
---|
| 51 | schema:
|
---|
| 52 | type: string
|
---|
| 53 | format: binary
|
---|
| 54 | 404:
|
---|
| 55 | description: Tile not found
|
---|
| 56 | content:
|
---|
| 57 | text/plain:
|
---|
| 58 | schema:
|
---|
| 59 | type: string
|
---|
| 60 | const: ''
|
---|
| 61 | 403:
|
---|
| 62 | $ref: './openapi.yaml#/components/responses/Unauthorized'
|
---|
| 63 | security:
|
---|
| 64 | - apiTokenName: []
|
---|
| 65 | apiTokenSecret: []
|
---|
| 66 | - sessionCookie: []
|
---|
Note:
See
TracBrowser
for help on using the repository browser.