rndpwd/openapi_public.yaml at main · tecnickcom/rndpwd · GitHub

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
91
92
93
94
95
96
97
98
99
100
101
102
103
openapi: 3.2.0
info:
  title: rndpwd
  description: Public API
  contact:
    email: info@tecnick.com
  license:
    name: Internal use only. All rights reserved.
    url: https://github.com/tecnickcom/rndpwd/blob/main/LICENSE
  version: 1.0.0
servers:
  - url: https://rndpwd:8071
security:
  - {}
tags:
  - name: ping
    description: Ping this service
  - name: uid
    description: generate a random UID
  - name: random
    description: generate a random values
paths:
  /ping:
    get:
      tags:
        - ping
      summary: Check if the service is reachable
      responses:
        '200':
          description: The service is reachable
          content:
            text/plain:
              schema:
                type: string
                description: OK
  /uid:
    get:
      tags:
        - uid
      summary: Generates a random UID
      responses:
        '200':
          description: Random UID
          content:
            application/json:
              schema:
                type: string
                description: UID
  /password:
    get:
      parameters:
        - $ref: '#/components/parameters/charset'
        - $ref: '#/components/parameters/length'
        - $ref: '#/components/parameters/quantity'
      tags:
        - random
      summary: Generates a list of random passwords
      responses:
        '200':
          description: Random passwords
          content:
            application/json:
              schema:
                type: array
                items:
                  type: string
                description: random passwords
        '400':
          description: Invalid parameter
components:
  parameters:
    charset:
      in: query
      name: charset
      required: false
      schema:
        type: string
        minLength: 1
        maxLength: 256
        pattern: '^[!"#$%&''()*+,\-./0-9:;<=>?@A-Z\[\\\]^_`a-z{|}~]+$'
      example: 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789'
    length:
      description: Password length.
      in: query
      name: length
      required: false
      schema:
        type: integer
        minimum: 1
        maximum: 4096
        default: 32
      example: 16
    quantity:
      description: Number passwords to generate.
      in: query
      name: quantity
      required: false
      schema:
        type: integer
        minimum: 1
        maximum: 1000
        default: 10
      example: 2