enrichment-coordinator-service/docs/api.yaml

swagger: '2.0'
info:
  description: This page lists all the rest apis for the service.
  version: '1.0'
  title: Enrichment Data service
host: 'localhost:8082'
basePath: /
tags:
  - name: A1-E Enrichment Data Consumer API
    description: Consumer Controller
  - name: Enrichment Data Producer API
    description: Producer Controller
  - name: Producer Simulator
    description: Producer Simulator Controller
paths:
  /A1-EI/v1/eitypes:
    get:
      tags:
        - A1-E Enrichment Data Consumer API
      summary: EI type identifiers
      operationId: getEiTypeIdentifiersUsingGET
      produces:
        - application/json
      responses:
        '200':
          description: EI type identifiers
          schema:
            type: array
            items:
              type: string
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      deprecated: false
  '/A1-EI/v1/eitypes/{eiTypeId}':
    get:
      tags:
        - A1-E Enrichment Data Consumer API
      summary: Individual EI type
      operationId: getEiTypeUsingGET
      produces:
        - application/json
      parameters:
        - name: eiTypeId
          in: path
          description: eiTypeId
          required: true
          type: string
      responses:
        '200':
          description: EI type
          schema:
            $ref: '#/definitions/EiType'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Enrichment Information type is not found
          schema:
            $ref: '#/definitions/error_information'
      deprecated: false
  '/A1-EI/v1/eitypes/{eiTypeId}/eijobs':
    get:
      tags:
        - A1-E Enrichment Data Consumer API
      summary: EI job identifiers
      operationId: getEiJobIdsUsingGET
      produces:
        - application/json
      parameters:
        - name: eiTypeId
          in: path
          description: eiTypeId
          required: true
          type: string
        - in: body
          name: owner
          description: identifies the owner of the job
          required: false
          schema:
            type: string
      responses:
        '200':
          description: EI job identifiers
          schema:
            type: array
            items:
              type: string
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Enrichment Information type is not found
          schema:
            $ref: '#/definitions/error_information'
      deprecated: false
  '/A1-EI/v1/eitypes/{eiTypeId}/eijobs/{eiJobId}':
    get:
      tags:
        - A1-E Enrichment Data Consumer API
      summary: Individual EI Job
      operationId: getIndividualEiJobUsingGET
      produces:
        - application/json
      parameters:
        - name: eiJobId
          in: path
          description: eiJobId
          required: true
          type: string
        - name: eiTypeId
          in: path
          description: eiTypeId
          required: true
          type: string
      responses:
        '200':
          description: EI Job
          schema:
            $ref: '#/definitions/EiJob'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Enrichment Information type or job is not found
          schema:
            $ref: '#/definitions/error_information'
      deprecated: false
    put:
      tags:
        - A1-E Enrichment Data Consumer API
      summary: Individual EI Job
      operationId: putIndividualEiJobUsingPUT
      consumes:
        - application/json
      produces:
        - application/json
      parameters:
        - name: eiJobId
          in: path
          description: eiJobId
          required: true
          type: string
        - in: body
          name: eiJobInfo
          description: eiJobInfo
          required: true
          schema:
            $ref: '#/definitions/EiJob'
        - name: eiTypeId
          in: path
          description: eiTypeId
          required: true
          type: string
      responses:
        '200':
          description: Job updated
        '201':
          description: Job created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Enrichment Information type is not found
          schema:
            $ref: '#/definitions/error_information'
      deprecated: false
    delete:
      tags:
        - A1-E Enrichment Data Consumer API
      summary: Individual EI Job
      operationId: deleteIndividualEiJobUsingDELETE
      produces:
        - application/json
      parameters:
        - name: eiJobId
          in: path
          description: eiJobId
          required: true
          type: string
        - name: eiTypeId
          in: path
          description: eiTypeId
          required: true
          type: string
      responses:
        '200':
          description: Not used
        '204':
          description: Job deleted
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Enrichment Information type or job is not found
          schema:
            $ref: '#/definitions/error_information'
      deprecated: false
  '/A1-EI/v1/eitypes/{eiTypeId}/eijobs/{eiJobId}/status':
    get:
      tags:
        - A1-E Enrichment Data Consumer API
      summary: EI Job status
      operationId: getEiJobStatusUsingGET
      produces:
        - application/json
      parameters:
        - name: eiJobId
          in: path
          description: eiJobId
          required: true
          type: string
        - name: eiTypeId
          in: path
          description: eiTypeId
          required: true
          type: string
      responses:
        '200':
          description: EI Job status
          schema:
            $ref: '#/definitions/EiJobStatus'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Enrichment Information type or job is not found
          schema:
            $ref: '#/definitions/error_information'
      deprecated: false
  /ei-producer/v1/eiproducers:
    get:
      tags:
        - Enrichment Data Producer API
      summary: EI producer identifiers
      operationId: getEiProducerIdentifiersUsingGET
      produces:
        - application/json
      responses:
        '200':
          description: EI producer identifiers
          schema:
            type: array
            items:
              type: string
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      deprecated: false
  '/ei-producer/v1/eiproducers/{eiProducerId}':
    get:
      tags:
        - Enrichment Data Producer API
      summary: Individual EI producer
      operationId: getEiProducerUsingGET
      produces:
        - application/json
      parameters:
        - name: eiProducerId
          in: path
          description: eiProducerId
          required: true
          type: string
      responses:
        '200':
          description: EI Jobs
          schema:
            $ref: '#/definitions/producer_registration_info'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Enrichment Information producer is not found
          schema:
            $ref: '#/definitions/error_information'
      deprecated: false
    put:
      tags:
        - Enrichment Data Producer API
      summary: Individual EI producer
      operationId: putEiProducerUsingPUT
      consumes:
        - application/json
      produces:
        - application/json
      parameters:
        - name: eiProducerId
          in: path
          description: eiProducerId
          required: true
          type: string
        - in: body
          name: registrationInfo
          description: registrationInfo
          required: true
          schema:
            $ref: '#/definitions/producer_registration_info'
      responses:
        '200':
          description: Producer updated
        '201':
          description: Producer created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      deprecated: false
    delete:
      tags:
        - Enrichment Data Producer API
      summary: Individual EI producer
      operationId: deleteEiProducerUsingDELETE
      produces:
        - application/json
      parameters:
        - name: eiProducerId
          in: path
          description: eiProducerId
          required: true
          type: string
      responses:
        '200':
          description: Not used
        '204':
          description: Producer deleted
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Producer is not found
          schema:
            $ref: '#/definitions/error_information'
      deprecated: false
  '/ei-producer/v1/eiproducers/{eiProducerId}/eijobs':
    get:
      tags:
        - Enrichment Data Producer API
      summary: EI job definitions
      description: EI job definitions for one EI producer
      operationId: getEiProducerJobsUsingGET
      produces:
        - application/json
      parameters:
        - name: eiProducerId
          in: path
          description: eiProducerId
          required: true
          type: string
      responses:
        '200':
          description: EI jobs
          schema:
            type: array
            items:
              $ref: '#/definitions/producer_ei_job_request'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Enrichment Information producer is not found
          schema:
            $ref: '#/definitions/error_information'
      deprecated: false
  '/ei-producer/v1/eiproducers/{eiProducerId}/status':
    get:
      tags:
        - Enrichment Data Producer API
      summary: EI producer status
      operationId: getEiProducerStatusUsingGET
      produces:
        - application/json
      parameters:
        - name: eiProducerId
          in: path
          description: eiProducerId
          required: true
          type: string
      responses:
        '200':
          description: EI jobs
          schema:
            $ref: '#/definitions/producer_status'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Enrichment Information producer is not found
          schema:
            $ref: '#/definitions/error_information'
      deprecated: false
  /ei-producer/v1/eitypes:
    get:
      tags:
        - Enrichment Data Producer API
      summary: EI type identifiers
      operationId: getEiTypeIdentifiersUsingGET_1
      produces:
        - application/json
      responses:
        '200':
          description: EI type identifiers
          schema:
            type: array
            items:
              type: string
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      deprecated: false
  '/ei-producer/v1/eitypes/{eiTypeId}':
    get:
      tags:
        - Enrichment Data Producer API
      summary: Individual EI Type
      operationId: getEiTypeUsingGET_1
      produces:
        - application/json
      parameters:
        - name: eiTypeId
          in: path
          description: eiTypeId
          required: true
          type: string
      responses:
        '200':
          description: EI type
          schema:
            $ref: '#/definitions/producer_ei_type_info'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Enrichment Information type is not found
          schema:
            $ref: '#/definitions/error_information'
      deprecated: false
  /producer_simulator/job_created:
    post:
      tags:
        - Producer Simulator
      summary: Callback for EI job creation
      operationId: jobCreatedCallbackUsingPOST
      consumes:
        - application/json
      produces:
        - application/json
      parameters:
        - in: body
          name: request
          description: request
          required: true
          schema:
            $ref: '#/definitions/producer_ei_job_request'
      responses:
        '200':
          description: OK
        '201':
          description: Created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      deprecated: false
  /producer_simulator/job_created_error:
    post:
      tags:
        - Producer Simulator
      summary: 'Callback for EI job creation, returns error'
      operationId: jobCreatedCallbackReturnErrorUsingPOST
      consumes:
        - application/json
      produces:
        - application/json
      parameters:
        - in: body
          name: request
          description: request
          required: true
          schema:
            $ref: '#/definitions/producer_ei_job_request'
      responses:
        '200':
          description: OK
        '201':
          description: Created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      deprecated: false
  /producer_simulator/job_deleted:
    post:
      tags:
        - Producer Simulator
      summary: Callback for EI job deletion
      operationId: jobDeletedCallbackUsingPOST
      consumes:
        - application/json
      produces:
        - application/json
      parameters:
        - in: body
          name: request
          description: request
          required: true
          schema:
            $ref: '#/definitions/producer_ei_job_request'
      responses:
        '200':
          description: OK
        '201':
          description: Created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      deprecated: false
  /producer_simulator/job_deleted_error:
    post:
      tags:
        - Producer Simulator
      summary: 'Callback for EI job creation, returns error'
      operationId: jobDeletedCallbackReturnErrorUsingPOST
      consumes:
        - application/json
      produces:
        - application/json
      parameters:
        - in: body
          name: request
          description: request
          required: true
          schema:
            $ref: '#/definitions/producer_ei_job_request'
      responses:
        '200':
          description: OK
        '201':
          description: Created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      deprecated: false
  /producer_simulator/supervision:
    get:
      tags:
        - Producer Simulator
      summary: Producer supervision
      operationId: producerSupervisionUsingGET
      produces:
        - application/json
      responses:
        '200':
          description: OK
          schema:
            type: string
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      deprecated: false
  /producer_simulator/supervision_error:
    get:
      tags:
        - Producer Simulator
      summary: Producer supervision error
      operationId: producerSupervisionErrorUsingGET
      produces:
        - application/json
      responses:
        '200':
          description: OK
          schema:
            type: string
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      deprecated: false
definitions:
  EiJob:
    type: object
    required:
      - jobOwner
      - jobParameters
      - targetUri
    properties:
      jobOwner:
        type: string
        description: Identity of the owner of the job
      jobParameters:
        type: object
        description: EI Type specific job data
      targetUri:
        type: string
        description: The target of the EI data
    title: EiJob
    description: Information for an Enrichment Information Job
  EiJobStatus:
    type: object
    required:
      - operationalState
    properties:
      operationalState:
        type: string
        description: |-
          Operational state, values:
          ENABLED: TBD
          DISABLED: TBD.
        enum:
          - ENABLED
          - DISABLED
    title: EiJobStatus
    description: Status for an EI Job
  EiType:
    type: object
    properties:
      eiJobParametersSchema:
        type: object
        description: Json schema for the job data
    title: EiType
    description: Information for an EI type
  Mono«ResponseEntity«object»»:
    type: object
    title: Mono«ResponseEntity«object»»
  error_information:
    type: object
    properties:
      detail:
        type: string
        example: EI job type not found
        description: A human-readable explanation specific to this occurrence of the problem.
      status:
        type: integer
        format: int32
        example: 404
        description: The HTTP status code generated by the origin server for this occurrence of the problem.
    title: error_information
    description: 'Problem as defined in https://tools.ietf.org/html/rfc7807'
  producer_ei_job_request:
    type: object
    required:
      - ei_job_identity
    properties:
      ei_job_data:
        type: object
        description: Json for the job data
      ei_job_identity:
        type: string
        description: Idenitity of the EI job
      ei_type_identity:
        type: string
        description: Type idenitity for the job
      target_uri:
        type: string
        description: URI for the target of the EI
    title: producer_ei_job_request
    description: The body of the EI producer callbacks for EI job creation and deletion
  producer_ei_type_info:
    type: object
    properties:
      ei_job_data_schema:
        type: object
        description: Json schema for the job data
      ei_producer_ids:
        type: array
        description: Registered producers
        items:
          type: string
    title: producer_ei_type_info
    description: Information for an EI type
  producer_ei_type_registration_info:
    type: object
    required:
      - ei_type_identity
    properties:
      ei_job_data_schema:
        type: object
        description: Json schema for the job data
      ei_type_identity:
        type: string
        description: EI type identity
    title: producer_ei_type_registration_info
    description: Information for an EI type
  producer_registration_info:
    type: object
    required:
      - ei_job_creation_callback_url
      - ei_job_deletion_callback_url
      - ei_producer_supervision_callback_url
      - supported_ei_types
    properties:
      ei_job_creation_callback_url:
        type: string
        description: callback for job creation
      ei_job_deletion_callback_url:
        type: string
        description: callback for job deletion
      ei_producer_supervision_callback_url:
        type: string
        description: callback for producer supervision
      supported_ei_types:
        type: array
        description: Supported EI types
        items:
          $ref: '#/definitions/producer_ei_type_registration_info'
    title: producer_registration_info
    description: Information for an EI producer
  producer_status:
    type: object
    required:
      - operational_state
    properties:
      operational_state:
        type: string
        description: |-
          Operational state, values:
          ENABLED: TBD
          DISABLED: TBD.
        enum:
          - ENABLED
          - DISABLED
    title: producer_status
    description: Status for an EI Producer
  void:
    type: object
    title: void
    description: Void/empty