openapi.yml


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90

openapi: 3.0.0
info:
  title: 'Nextcloud Maps API'
  version: '1.0'
  contact:
    name: Nextcloud Maps Team
    url: https://github.com/nextcloud/maps/
externalDocs:
  description: 'Based on a loose description in this ticket: https://github.com/nextcloud/maps/issues/92'
  url: 'https://github.com/nextcloud/maps/issues/92'
servers: 
  - url: https://{hostname}:{port}/index.php/apps/maps/api/1.0/
    variables:
      hostname:
        default: localhost
      port:
        default: '8080'
paths:
  /favorites:
    get:
      operationId: get-favorites
      summary: 'Get a list of the favorites'
      responses:
        '200':
          description: Success
    post:
      operationId: add-favorites
      summary: 'Add a favorite'
      responses:
        '200':
          description: Success
      requestBody:
        $ref: '#/components/requestBodies/favoriteBody'
  /favorites/{id}:
    parameters:
      - name: id
        in: path
        description: ID of favorite to use
        required: true
        schema:
          type: integer
    put:
      operationId: edit-favorites
      summary: 'Edit a favorite.'
      responses:
        '200':
          description: Success
      requestBody:
        $ref: '#/components/requestBodies/favoriteBody'

    delete:
      operationId: delete-favorites
      summary: 'Deletes a favorite'
      responses:
        '200':
          description: Success
components:
  requestBodies:
    favoriteBody:
      description: 'favorite data'
      required: true
      content:
        'application/json':
          schema:
            $ref: '#/components/schemas/favorite-body'
  schemas:
    favorite-body:
      type: object
      title: 'Fav body'
      properties:
        name:
          type: string
          title: 'Favorite name'
        lat:
          type: number
          title: Latitude
          format: float
        lng:
          type: number
          title: Longitude
          format: float
        category:
          type: string
          title: Category
        comment:
          type: string
          title: Comment
        extensions:
          type: string
          title: Extensions