nhs-notify-supplier-api/specification/api/notify-supplier-phase1.yml at e36d23013f8cf871c9cafc5df5f499943cf50c19 · NHSDigital/nhs-notify-supplier-api · 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
openapi: 3.0.3
info:
  version: next
  title: NHS Notify Supplier API
  description:
    $ref: 'components/documentation/APIDescription.md'
security:
  - $ref: 'components/security/security.yml'
paths:
  /letters:
    parameters:
      - $ref: 'components/parameters/authorization/authorization.yml'
      - $ref: 'components/parameters/requestId.yml'
      - $ref: 'components/parameters/correlationId.yml'
    post:
      $ref: 'components/endpoints/postLetters.yml'
    get:
      $ref: 'components/endpoints/listLetters.yml'
  '/letters/{id}':
    parameters:
      - $ref: 'components/parameters/authorization/authorization.yml'
      - $ref: 'components/parameters/requestId.yml'
      - $ref: 'components/parameters/correlationId.yml'
      - $ref: 'components/parameters/resourceId.yml'
    get:
      $ref: 'components/endpoints/getLetterStatus.yml'
    patch:
      $ref: 'components/endpoints/patchLetter.yml'
  '/letters/{id}/data':
    parameters:
      - $ref: 'components/parameters/authorization/authorization.yml'
      - $ref: 'components/parameters/resourceId.yml'
      - $ref: 'components/parameters/requestId.yml'
      - $ref: 'components/parameters/correlationId.yml'
    get:
      $ref: 'components/endpoints/getDataId.yml'
    #head:
    #  $ref: 'components/endpoints/headDataId.yml'
  /mi:
    parameters:
      - $ref: 'components/parameters/authorization/authorization.yml'
      - $ref: 'components/parameters/requestId.yml'
      - $ref: 'components/parameters/correlationId.yml'
    post:
      $ref: 'components/endpoints/createMI.yml'
  /_status:
    get:
      description: Returns 200 OK if the service is up.
      operationId: getStatus
      responses:
        "200":
          description: Service is healthy
      summary: Health check
components:
  securitySchemes:
    $ref: ./components/security-schemes/security-schemes.yml

tags:
  - name: letter
    description: ''
  - name: mi
    description: ''
  - name: data
    description: ''
servers:
  - url: 'https://internal-dev-sandbox.api.service.nhs.uk/nhs-notify-supplier'
    description: Public sandbox
  - url: 'http://127.0.0.1:9000'
    description: Local development server
x-nhsd-apim:
  temporary: false
  monitoring: false
  access:
    $ref: ./components/x-nhsd-apim/access.yml
  target:
    $ref: ./components/x-nhsd-apim/target.yml
  target-attributes:
    $ref: ./components/x-nhsd-apim/target-attributes.yml
  ratelimiting:
    $ref: ./components/x-nhsd-apim/rate-limiting.yml