Mercedes-Benz Mercedes me Diagnostic Trouble Code (DTC) Snapshots API

openapi: 3.2.0
info:
  contact:
    name: The open API platform by Mercedes-Benz
    x-twitter: MercedesBenz
  description: The Remote Diagnostic Support API will provide the possibility for 3rd party applications (e.g. ADAC, ATU, etc.) to access vehicle diagnostics data remotely on behalf of the Daimler customer. To use the endpoints you need a valid vin/fin (vehicleId).
  title: Remote Diagnostic Support Diagnostic Trouble Code (DTC)…
  version: '1.0'
  x-apisguru-categories:
  - transport
  x-logo:
    url: https://twitter.com/MercedesBenz/profile_image?size=original
  x-origin:
  - format: swagger
    url: https://developer.mercedes-benz.com/content/sites/default/files/2018-10/swagger_remote_diagnostics_api_2.yaml
    version: '2.0'
  x-providerName: mercedes-benz.com
  x-serviceName: diagnostics
servers:
- url: https://api.mercedes-benz.com/remotediagnostic_tryout/v1
tags:
- description: Remote Diagnostic Support service for view dtc snapshot List.
  name: Diagnostic Trouble Code (DTC) Snapshots
paths:
  /vehicles/{vehicleId}/ecuId/{ecuId}/dtcId/{dtcId}/dtcSnapshotReadouts:
    post:
      description: 'This API creates a readout of a DTC snapshot from one vehicle. If the result is available immediately, the result is returned. If the result isn''t available, a location to the DTC snapshot readout is returned. This location shall be polled until the result is available. INFO: GET Requests are not yet supported!'
      operationId: getDtcSnapshotReadoutsUsingPOST
      parameters:
      - description: The vehicle identifier of the vehicle to read from
        in: path
        name: vehicleId
        required: true
        x-example: WDD111111PKW01000
        schema:
          type: string
      - description: The id of the ECU to read from
        in: path
        name: ecuId
        required: true
        x-example: DTR212
        schema:
          type: string
      - description: The id of the DTC associated with the snapshot
        in: path
        name: dtcId
        required: true
        x-example: C163AFA
        schema:
          type: string
      responses:
        '201':
          description: Returns a DTC Snapshot List
          content:
            application/x.exve.org.dtcSnapshotReadout.v1+json;charset=utf-8:
              schema:
                $ref: '#/components/schemas/DtcSnapshotDataContainer'
            application/json;charset=utf-8:
              schema:
                $ref: '#/components/schemas/DtcSnapshotDataContainer'
        '202':
          description: The request has been accepted for processing, but not completed.
        '204':
          description: The request has been accepted for processing, but no content is available.
        '400':
          description: Bad Request
          content:
            application/x.exve.org.dtcSnapshotReadout.v1+json;charset=utf-8:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
            application/json;charset=utf-8:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/x.exve.org.dtcSnapshotReadout.v1+json;charset=utf-8:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
            application/json;charset=utf-8:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '402':
          description: Payment required
          content:
            application/x.exve.org.dtcSnapshotReadout.v1+json;charset=utf-8:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
            application/json;charset=utf-8:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden
          content:
            application/x.exve.org.dtcSnapshotReadout.v1+json;charset=utf-8:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
            application/json;charset=utf-8:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Resource Not Found
          content:
            application/x.exve.org.dtcSnapshotReadout.v1+json;charset=utf-8:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
            application/json;charset=utf-8:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '406':
          description: Not Acceptable
          content:
            application/x.exve.org.dtcSnapshotReadout.v1+json;charset=utf-8:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
            application/json;charset=utf-8:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Quota limit is exceeded.
        '500':
          description: Internal server error
          content:
            application/x.exve.org.dtcSnapshotReadout.v1+json;charset=utf-8:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
            application/json;charset=utf-8:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '501':
          description: Not Implemented
          content:
            application/x.exve.org.dtcSnapshotReadout.v1+json;charset=utf-8:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
            application/json;charset=utf-8:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Service Unavailable
          content:
            application/x.exve.org.dtcSnapshotReadout.v1+json;charset=utf-8:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
            application/json;charset=utf-8:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '505':
          description: Version not supported
          content:
            application/x.exve.org.dtcSnapshotReadout.v1+json;charset=utf-8:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
            application/json;charset=utf-8:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: View the List of Dtc Snapshot for Specific vehicleId
      tags:
      - Diagnostic Trouble Code (DTC) Snapshots
components:
  schemas:
    DtcSnapshotDataContainer:
      properties:
        dtcSnapshotReadout:
          $ref: '#/components/schemas/DtcSnapshotDataType'
      type: object
    CommonType:
      properties:
        asyncEstimatedComplete:
          description: Not Implemented. Estimated completion time of the readout
          format: date-time
          type: string
        asyncProgress:
          description: Not Implemented. Progress of the readout in percent.
          format: int32
          type: integer
        asyncStatus:
          description: Reflects the status of the readouts
          enum:
          - Pending
          - InProgress
          - Complete
          - Fail
          type: string
        asyncWait:
          description: Not Implemented. Recommended waiting time in milliseconds until next request for status.
          format: int64
          type: integer
        exveErrorId:
          description: The id of the error in case something failed
          type: string
        exveErrorMsg:
          description: The error message in case something failed
          type: string
        exveErrorRef:
          description: A unique reference to the error. Can be used in communication with the offering party to help in resolving problems.
          type: string
        exveNote:
          description: A message regarding the result of the request. Can be filled both when the request was completed and failed.
          type: string
        id:
          description: Id unique for this readout.
          type: string
        messageTimestamp:
          description: Timestamp when this message was created.
          format: date-time
          type: string
        receivedTimestamp:
          description: Timestamp when the data in the message was received by the ExVe backend from the vehicle.
          format: date-time
          type: string
        vehicleId:
          description: The vehicle identifier of the extended vehicle, e.g VIN
          type: string
      required:
      - id
      - messageTimestamp
      - asyncStatus
      - vehicleId
      type: object
    DtcSnapshotDataType:
      allOf:
      - $ref: '#/components/schemas/CommonType'
      - properties:
          dtcId:
            description: Identifier of the DTC
            type: string
          dtcSnapshotParameters:
            description: List of dtcSnapshotParameters.
            items:
              $ref: '#/components/schemas/DtcSnapshotDataItem'
            type: array
          ecuId:
            description: Identifier of the ECU
            type: string
        required:
        - dtcId
        - ecuId
        type: object
    ErrorResponse:
      properties:
        errorCode:
          description: Error Code
          type: string
        errorMessage:
          description: Error Message
          type: string
      type: object
    DtcSnapshotDataItem:
      properties:
        id:
          description: Name of snapshot parameter
          type: string
        value:
          description: Value of snapshot parameter
          type: string
      required:
      - id
      - value
      type: object
x-default-token: a1b2c3d4-a1b2-a1b2-a1b2-a1b2c3d4e5f6