Compare commits

..

2 Commits

Author SHA1 Message Date
Sebastian H. Gabrielli
9f47d9840c yes 2023-12-25 17:59:24 +01:00
Sebastian H. Gabrielli
13f0c6df6c yes 2023-12-25 17:59:19 +01:00
7 changed files with 75 additions and 43 deletions

View File

@ -1,7 +1,7 @@
_id: spc_df2177e61a724e24bc4fc1796d631d51 _id: spc_df2177e61a724e24bc4fc1796d631d51
type: ApiSpec type: ApiSpec
parentId: wrk_0627d19078e64bb7877a6c1703c0fab8 parentId: wrk_0627d19078e64bb7877a6c1703c0fab8
modified: 1703326273885 modified: 1703520317303
created: 1703261567280 created: 1703261567280
fileName: member-spec-sample.yaml fileName: member-spec-sample.yaml
contents: "openapi: 3.0.0 contents: "openapi: 3.0.0
@ -31,20 +31,16 @@ contents: "openapi: 3.0.0
\ description: \"OmegaV API server\" \ description: \"OmegaV API server\"
\ - url: \"http://127.0.0.1:8000\"
\ description: \"Local test\"
tags: tags:
\ - name: member \ - name: member
\ description: \"Operations about a member\" \ description: \"Operations about a member\"
\ - name: money
\ description: \"Operations about money\"
\ - name: RFID
\ description: \"Operations about a member's RFID card\"
paths: paths:
@ -101,7 +97,7 @@ contents: "openapi: 3.0.0
\ schema: \ schema:
\ $ref: \"#/components/schemas/minimalMember\" \ $ref: \"#/components/schemas/minimalMemberWithoutId\"
\ required: true \ required: true
@ -164,7 +160,7 @@ contents: "openapi: 3.0.0
\ schema: \ schema:
\ $ref: '#/components/schemas/members' \ $ref: '#/components/schemas/member'
\ '404': \ '404':
@ -190,7 +186,7 @@ contents: "openapi: 3.0.0
\ in: path \ in: path
\ description: \"ID of the user's who's balance will be fetched\" \ description: \"ID of the user's who's info that will be updated\"
\ required: true \ required: true
@ -208,7 +204,7 @@ contents: "openapi: 3.0.0
\ schema: \ schema:
\ $ref: '#/components/schemas/minimalMember' \ $ref: '#/components/schemas/minimalMemberWithoutId'
\ responses: \ responses:
@ -222,7 +218,7 @@ contents: "openapi: 3.0.0
\ schema: \ schema:
\ $ref: '#/components/schemas/members' \ $ref: '#/components/schemas/member'
\ '404': \ '404':
@ -242,8 +238,6 @@ contents: "openapi: 3.0.0
\ - member \ - member
\ - money
\ summary: \"Get a member's balance\" \ summary: \"Get a member's balance\"
\ description: \"Get a member's balance\" \ description: \"Get a member's balance\"
@ -294,8 +288,6 @@ contents: "openapi: 3.0.0
\ - member \ - member
\ - money
\ summary: \"Change a member's balance\" \ summary: \"Change a member's balance\"
\ description: \"Add to a member's balance\" \ description: \"Add to a member's balance\"
@ -482,8 +474,6 @@ contents: "openapi: 3.0.0
\ - member \ - member
\ - RFID
\ summary: \"Get a member's RFID cards\" \ summary: \"Get a member's RFID cards\"
\ description: \"Get all of a member's RFID cards\" \ description: \"Get all of a member's RFID cards\"
@ -534,8 +524,6 @@ contents: "openapi: 3.0.0
\ - member \ - member
\ - RFID
\ summary: \"Add RFID card\" \ summary: \"Add RFID card\"
\ description: \"Add an RFID card to a member\" \ description: \"Add an RFID card to a member\"
@ -617,13 +605,57 @@ contents: "openapi: 3.0.0
\ $ref: '#/components/schemas/member' \ $ref: '#/components/schemas/member'
\\
\ minimalMemberWithoutId:
\ type: object
\ description: \"The minimal values needed to create a member\"
\ properties:
\ ntnuUsername:
\ type: string
\ description: \"The NTNU username of the member\"
\ example: \"sebasthg\"
\ firstName:
\ type: string
\ description: \"First name of the member\"
\ example: \"Sebastian\"
\ lastName:
\ type: string
\ description: \"Last name of the member\"
\ example: \"Gabrielli\"
\ email:
\ type: string
\ description: \"The member's non-ntnu e-mail\"
\ example: \"sebastian@fastmail.mx\"
\ \
\ \ \ \
\ minimalMember: \ minimalMember:
\ type: object \ type: object
\ description: \"The minimal values needed to create a member\" \ description: \"The minimal values returned when createing a member\"
\ properties: \ properties:
@ -637,7 +669,7 @@ contents: "openapi: 3.0.0
\ example: 1337 \ example: 1337
\ ntnuBrukernavn: \ ntnuUsername:
\ type: string \ type: string
@ -690,7 +722,7 @@ contents: "openapi: 3.0.0
\ example: 1337 \ example: 1337
\ ntnuBrukernavn: \ ntnuUsername:
\ type: string \ type: string
@ -788,7 +820,7 @@ contents: "openapi: 3.0.0
\ example: \"0364249683\" \ example: \"0364249683\"
\ cardDomment: \ cardComment:
\ type: string \ type: string

View File

@ -1,9 +1,9 @@
_id: req_0dbc0849841c4537a7ba56051747ad9b _id: req_0dbc0849841c4537a7ba56051747ad9b
type: Request type: Request
parentId: fld_1f771e8034294c2a9c6396fd6787b6af parentId: fld_1f771e8034294c2a9c6396fd6787b6af
modified: 1703325211504 modified: 1703519866807
created: 1703325202646 created: 1703325202646
url: "{{ _.base_url }}/members/{{ _.memberId }}/balance" url: 127.0.0.1:8000/member/1/balance
name: Change a member's balance name: Change a member's balance
description: "" description: ""
method: PUT method: PUT
@ -11,7 +11,7 @@ body:
mimeType: application/json mimeType: application/json
text: |- text: |-
{ {
"balance": 1337 "balance": -50
} }
parameters: [] parameters: []
headers: headers:

View File

@ -1,9 +1,9 @@
_id: req_38c60dbc1949493fa350f316027aa30e _id: req_38c60dbc1949493fa350f316027aa30e
type: Request type: Request
parentId: fld_1f771e8034294c2a9c6396fd6787b6af parentId: fld_1f771e8034294c2a9c6396fd6787b6af
modified: 1703325202644 modified: 1703519813169
created: 1703325202644 created: 1703325202644
url: "{{ _.base_url }}/members/{{ _.memberId }}/balance" url: 127.0.0.1:8000/member/1/balance
name: Get a member's balance name: Get a member's balance
description: "" description: ""
method: GET method: GET

View File

@ -1,9 +1,9 @@
_id: req_6d5655cd78fd4d05a2c06b5bc443c3fa _id: req_6d5655cd78fd4d05a2c06b5bc443c3fa
type: Request type: Request
parentId: fld_1f771e8034294c2a9c6396fd6787b6af parentId: fld_1f771e8034294c2a9c6396fd6787b6af
modified: 1703325202640 modified: 1703505568127
created: 1703325202640 created: 1703325202640
url: "{{ _.base_url }}/members" url: 127.0.0.1:8000/members
name: Get a list of all members name: Get a list of all members
description: "" description: ""
method: GET method: GET

View File

@ -1,9 +1,9 @@
_id: req_87b162ac1d564368a8933372f62f6437 _id: req_87b162ac1d564368a8933372f62f6437
type: Request type: Request
parentId: fld_1f771e8034294c2a9c6396fd6787b6af parentId: fld_1f771e8034294c2a9c6396fd6787b6af
modified: 1703325202641 modified: 1703508166488
created: 1703325202641 created: 1703325202641
url: "{{ _.base_url }}/members" url: 127.0.0.1:8000/member
name: Add a new member name: Add a new member
description: "" description: ""
method: POST method: POST
@ -11,8 +11,7 @@ body:
mimeType: application/json mimeType: application/json
text: |- text: |-
{ {
"id": 1337, "ntnuUsername": "definitely-not-sebasthg",
"ntnuBrukernavn": "sebasthg",
"firstName": "Sebastian", "firstName": "Sebastian",
"lastName": "Gabrielli", "lastName": "Gabrielli",
"email": "sebastian@fastmail.mx" "email": "sebastian@fastmail.mx"
@ -22,6 +21,7 @@ headers:
- name: Content-Type - name: Content-Type
disabled: false disabled: false
value: application/json value: application/json
id: pair_97cb010b74c0417da634ed9d7ef8dd77
authentication: {} authentication: {}
metaSortKey: -1703325202641 metaSortKey: -1703325202641
isPrivate: false isPrivate: false

View File

@ -1,9 +1,9 @@
_id: req_98985848bfd3459c9961a645b9048841 _id: req_98985848bfd3459c9961a645b9048841
type: Request type: Request
parentId: fld_1f771e8034294c2a9c6396fd6787b6af parentId: fld_1f771e8034294c2a9c6396fd6787b6af
modified: 1703325202643 modified: 1703518570913
created: 1703325202643 created: 1703325202643
url: "{{ _.base_url }}/members/{{ _.memberId }}" url: 127.0.0.1:8000/member/1
name: Get a member name: Get a member
description: "" description: ""
method: GET method: GET

View File

@ -1,9 +1,9 @@
_id: req_c599698644fa45dd8f6a72424695130c _id: req_c599698644fa45dd8f6a72424695130c
type: Request type: Request
parentId: fld_1f771e8034294c2a9c6396fd6787b6af parentId: fld_1f771e8034294c2a9c6396fd6787b6af
modified: 1703325202644 modified: 1703518818144
created: 1703325202644 created: 1703325202644
url: "{{ _.base_url }}/members/{{ _.memberId }}" url: 127.0.0.1:8000/member/1
name: Update a member's details name: Update a member's details
description: "" description: ""
method: PUT method: PUT
@ -11,8 +11,8 @@ body:
mimeType: application/json mimeType: application/json
text: |- text: |-
{ {
"id": 1337, "id": 1,
"ntnuBrukernavn": "sebasthg", "ntnuUsername": "sebasthg2",
"firstName": "Sebastian", "firstName": "Sebastian",
"lastName": "Gabrielli", "lastName": "Gabrielli",
"email": "sebastian@fastmail.mx" "email": "sebastian@fastmail.mx"