Beskrivning
Generell tjänst för att lagra och hämta anteckningar kopplad till en organisation eller en medborgare.
Livscykelstatus
Under utvecklingProduktion
Lösningsbeskrivning
| imageAttachmentId | att929890329 |
|---|
| macroId | 0623c889-3260-4597-85dd-185d4fa90038 |
|---|
| baseUrl | https://sundsvall.atlassian.net/wiki |
|---|
| displayName | notes Copy |
|---|
| name | notes Copy |
|---|
|
| diagramAttachmentId | att931233799 |
|---|
| containerId | 931332097 |
|---|
timestamp | 1644565587972
Hantering av personuppgifter
<Vilka Inga personuppgifter hanteras och varför?>i denna tjänst.
API specifikation
| swaggeropen-ui |
|---|
openapi: 3.0.1
info:
title: api-notes
contact: {}
license:
name: MIT
url: 'https://opensource.org/licenses/MIT'
version: '1.0'
servers:
- url: /
security:
- default: []
tags:
- name: Notes
description: Notes
paths:
/notes:
get:
tags:
- Notes
summary: 'Get all notes, filtered by partyId'
operationId: getNotesByPartyId
parameters:
- name: partyId
in: query
description: PartyID
required: true
style: form
explode: true
schema:
type: string
example: 81471222-5798-11e9-ae24-57fa13b361e1
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Note'
application/problem+json:
schema:
type: array
items:
$ref: '#/components/schemas/Note'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Problem'
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/Problem'
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
'500':
description: Internal Server error
content:
application/json:
schema:
$ref: '#/components/schemas/Problem'
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
post:
tags:
- Notes
summary: Create new note
operationId: createNote
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateNoteRequest'
required: true
responses:
'201':
description: Successful operation
headers:
Location:
style: simple
explode: false
schema:
type: string
'400':
description: Bad request
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
'404':
description: Not found
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
'500':
description: Internal Server error
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
security:
- default: []
x-auth-type: Application & Application User
x-throttling-tier: Unlimited
x-wso2-application-security:
security-types:
- oauth2
optional: false
'/notes/{id}':
get:
tags:
- Notes
summary: Get note by ID
operationId: getNoteById
parameters:
- name: id
in: path
description: Note ID
required: true
style: simple
explode: false
schema:
type: string
example: b82bd8ac-1507-4d9a-958d-369261eecc15
responses:
'200':
description: Successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/Note'
application/problem+json:
schema:
$ref: '#/components/schemas/Note'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Problem'
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/Problem'
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
'500':
description: Internal Server error
content:
application/json:
schema:
$ref: '#/components/schemas/Problem'
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
security:
- default: []
x-auth-type: Application & Application User
x-throttling-tier: Unlimited
x-wso2-application-security:
security-types:
- oauth2
optional: false
delete:
tags:
- Notes
summary: Delete note by ID
operationId: deleteNoteById
parameters:
- name: id
in: path
description: Note ID
required: true
style: simple
explode: false
schema:
type: string
example: b82bd8ac-1507-4d9a-958d-369261eecc15
responses:
'204':
description: Successful operation
'400':
description: Bad request
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
'404':
description: Not found
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
'500':
description: Internal Server error
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
security:
- default: []
x-auth-type: Application & Application User
x-throttling-tier: Unlimited
x-wso2-application-security:
security-types:
- oauth2
optional: false
patch:
tags:
- Notes
summary: Update note
operationId: updateNote
parameters:
- name: id
in: path
description: Note ID
required: true
style: simple
explode: false
schema:
type: string
example: b82bd8ac-1507-4d9a-958d-369261eecc15
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateNoteRequest'
required: true
responses:
'200':
description: Successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/Note'
application/problem+json:
schema:
$ref: '#/components/schemas/Note'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Problem'
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/Problem'
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
'500':
description: Internal Server error
content:
application/json:
schema:
$ref: '#/components/schemas/Problem'
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
security:
- default: []
x-auth-type: Application & Application User
x-throttling-tier: Unlimited
x-wso2-application-security:
security-types:
- oauth2
optional: false
components:
schemas:
CreateNoteRequest:
required:
- body
- createdBy
- subject
type: object
properties:
partyId:
type: string
description: Party ID (e.g. a personId or an organizationId)
example: 81471222-5798-11e9-ae24-57fa13b361e1
subject:
maximum: 256
maxLength: 256
minLength: 1
type: string
description: The note subject
example: This is a subject
body:
maximum: 2048
maxLength: 2048
minLength: 1
type: string
description: The note nody
example: This is a note
createdBy:
type: string
description: Created by
example: John Doe
description: CreateNoteRequest model
Problem:
type: object
properties:
instance:
type: string
format: uri
type:
type: string
format: uri
parameters:
type: object
additionalProperties:
type: object
status:
$ref: '#/components/schemas/StatusType'
title:
type: string
detail:
type: string
StatusType:
type: object
properties:
statusCode:
type: integer
format: int32
reasonPhrase:
type: string
UpdateNoteRequest:
required:
- body
- modifiedBy
- subject
type: object
properties:
subject:
maximum: 256
maxLength: 256
minLength: 1
type: string
description: The note subject
example: This is a subject
body:
maximum: 2048
maxLength: 2048
minLength: 1
type: string
description: The note nody
example: This is a note
modifiedBy:
type: string
description: Modified by
example: John Doe
description: UpdateNoteRequest model
Note:
type: object
properties:
id:
type: string
description: Note ID
example: b82bd8ac-1507-4d9a-958d-369261eecc15
partyId:
type: string
description: Party ID (e.g. a personId or an organizationId)
example: 81471222-5798-11e9-ae24-57fa13b361e1
subject:
type: string
description: The note subject
example: This is a subject
body:
type: string
description: The note nody
example: This is a note
createdBy:
type: string
description: Created by
example: John Doe
modifiedBy:
type: string
description: Modified by
example: John Doe
created:
type: string
description: Created timestamp
format: date-time
modified:
type: string
description: Modified timestamp
format: date-time
description: CreateNoteRequest model
| api |
|---|
| showCommonExtensions | true |
|---|
| deepLinking | true |
|---|
| supportedSubmitMethods | none |
|---|
| location | url |
|---|
| showExtensions | true |
|---|
| url | https://api-test.sundsvall.se/notes/api-docs |
|---|
|
|