enrichment-coordinator-service/docs/api.yaml

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