{
"openapi": "3.0.1",
"info": {
"title": "MindKey OData Connector 2.0 - TimeTracking",
"description": "MindKey OData Connector",
"version": "2.0"
},
"servers": [
{
"url": "https://connector.mindkey.com"
}
],
"paths": {
"/odata/v2/TimeTracking": {
"get": {
"tags": [
"TimeTracking"
],
"summary": "Retrieve a list of time tracking entries",
"description": "Response is limited to 3000 records. Follow '@odata.nextLink' to retrieve the next page.",
"operationId": "TimeTrackings",
"parameters": [
{
"name": "$skip",
"in": "query",
"description": "Skip N. See https://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_SystemQueryOptionskip",
"schema": {
"type": "number"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/TimeTrackingIEnumerableODataResponse"
}
}
}
},
"401": {
"description": "Unauthorized"
},
"400": {
"description": "Bad request. Occurs if the request payload or querystring contains invalid data",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
}
}
}
}
}
},
"/odata/v2/TimeTrackingCode": {
"get": {
"tags": [
"TimeTrackingCode"
],
"summary": "Retrieve a list of time tracking codes",
"description": "Response is limited to 3000 records. Follow '@odata.nextLink' to retrieve the next page.",
"operationId": "TimeTrackingCodes",
"parameters": [
{
"name": "$skip",
"in": "query",
"description": "Skip N. See https://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_SystemQueryOptionskip",
"schema": {
"type": "number"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/TimeTrackingCodeIEnumerableODataResponse"
}
}
}
},
"401": {
"description": "Unauthorized"
},
"400": {
"description": "Bad request. Occurs if the request payload or querystring contains invalid data",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
}
}
}
}
}
},
"/odata/v2/TimeTrackingGroup": {
"get": {
"tags": [
"TimeTrackingGroup"
],
"summary": "Retrieve a list of time tracking groups",
"description": "Response is limited to 3000 records. Follow '@odata.nextLink' to retrieve the next page.",
"operationId": "TimeTrackingGroups",
"parameters": [
{
"name": "$skip",
"in": "query",
"description": "Skip N. See https://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_SystemQueryOptionskip",
"schema": {
"type": "number"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/TimeTrackingGroupIEnumerableODataResponse"
}
}
}
},
"401": {
"description": "Unauthorized"
},
"400": {
"description": "Bad request. Occurs if the request payload or querystring contains invalid data",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
}
}
}
}
}
},
"/odata/v2/TimeTrackingIntegration": {
"get": {
"tags": [
"TimeTrackingIntegration"
],
"summary": "Retrieve a list of time tracking integrations",
"description": "Response is limited to 3000 records. Follow '@odata.nextLink' to retrieve the next page.",
"operationId": "TimeTrackingIntegrations",
"parameters": [
{
"name": "$skip",
"in": "query",
"description": "Skip N. See https://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_SystemQueryOptionskip",
"schema": {
"type": "number"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/TimeTrackingIntegrationIEnumerableODataResponse"
}
}
}
},
"401": {
"description": "Unauthorized"
},
"400": {
"description": "Bad request. Occurs if the request payload or querystring contains invalid data",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
}
}
}
}
}
}
},
"components": {
"schemas": {
"CurrentPosition": {
"type": "object",
"properties": {
"positionId": {
"type": "string",
"nullable": true
},
"employeeId": {
"type": "string",
"nullable": true
},
"title": {
"type": "string",
"nullable": true
},
"locationId": {
"type": "string",
"nullable": true
},
"organizationId": {
"type": "string",
"nullable": true
},
"employmentCategoryName": {
"type": "string",
"nullable": true
},
"dimension1Id": {
"type": "string",
"nullable": true
},
"dimension2Id": {
"type": "string",
"nullable": true
},
"dimension3Id": {
"type": "string",
"nullable": true
},
"dimension4Id": {
"type": "string",
"nullable": true
},
"externalReference": {
"type": "string",
"nullable": true
}
},
"additionalProperties": false
},
"ProblemDetails": {
"type": "object",
"properties": {
"type": {
"type": "string",
"nullable": true
},
"title": {
"type": "string",
"nullable": true
},
"status": {
"type": "integer",
"format": "int32",
"nullable": true
},
"detail": {
"type": "string",
"nullable": true
},
"instance": {
"type": "string",
"nullable": true
}
},
"additionalProperties": { }
},
"SimpleEmployee": {
"type": "object",
"properties": {
"employeeId": {
"type": "string",
"nullable": true
},
"externalReference": {
"type": "string",
"nullable": true
},
"initials": {
"type": "string",
"nullable": true
},
"email": {
"type": "string",
"nullable": true
},
"nameFirstName": {
"type": "string",
"nullable": true
},
"nameMiddleName": {
"type": "string",
"nullable": true
},
"nameLastName": {
"type": "string",
"nullable": true
},
"nameFullName": {
"type": "string",
"nullable": true
},
"hiredDate": {
"type": "string",
"format": "date-time",
"nullable": true
},
"seniorityDate": {
"type": "string",
"format": "date-time",
"nullable": true
},
"terminatedDate": {
"type": "string",
"format": "date-time",
"nullable": true
},
"position": {
"$ref": "#/components/schemas/CurrentPosition"
}
},
"additionalProperties": false
},
"TimeTracking": {
"type": "object",
"properties": {
"timeTrackingId": {
"type": "string",
"nullable": true
},
"employeeId": {
"type": "string",
"nullable": true
},
"approvedDateTime": {
"type": "string",
"format": "date-time",
"nullable": true
},
"approvalStatus": {
"type": "integer",
"format": "int32"
},
"approver": {
"type": "string",
"nullable": true
},
"submitter": {
"type": "string",
"nullable": true
},
"timeTrackingCodeName": {
"type": "string",
"nullable": true
},
"transDate": {
"type": "string",
"format": "date-time"
},
"startTime": {
"type": "string",
"format": "date-time",
"nullable": true
},
"endTime": {
"type": "string",
"format": "date-time",
"nullable": true
},
"description": {
"type": "string",
"nullable": true
},
"balanceEffect": {
"type": "number",
"format": "double"
},
"nuisanceEffect": {
"type": "number",
"format": "double"
},
"allDay": {
"type": "boolean"
},
"hours": {
"type": "number",
"format": "double"
},
"rowNumber": {
"type": "integer",
"format": "int32"
},
"createdBy": {
"type": "string",
"nullable": true
},
"createdDateTime": {
"type": "string",
"format": "date-time"
},
"modifiedBy": {
"type": "string",
"nullable": true
},
"modifiedDateTime": {
"type": "string",
"format": "date-time",
"nullable": true
},
"versionStamp": {
"type": "integer",
"format": "int32"
},
"documentsExists": {
"type": "boolean"
},
"origin": {
"type": "integer",
"format": "int32"
},
"batchId": {
"type": "string",
"nullable": true
},
"timeTrackingCode": {
"$ref": "#/components/schemas/TimeTrackingCode"
},
"employee": {
"$ref": "#/components/schemas/SimpleEmployee"
}
},
"additionalProperties": false
},
"TimeTrackingCode": {
"type": "object",
"properties": {
"timeTrackings": {
"type": "array",
"items": {
"$ref": "#/components/schemas/TimeTracking"
},
"nullable": true
},
"timeTrackingGroups": {
"type": "array",
"items": {
"$ref": "#/components/schemas/TimeTrackingGroup"
},
"nullable": true
},
"timeTrackingCodeName": {
"type": "string",
"nullable": true
},
"percentDayOff": {
"type": "number",
"format": "double"
},
"nuisanceEffectFrom": {
"type": "string",
"format": "date-time",
"nullable": true
},
"allDayAllowed": {
"type": "boolean"
},
"negativeValueAllowed": {
"type": "boolean"
},
"rowNumber": {
"type": "integer",
"format": "int32"
},
"createdBy": {
"type": "string",
"nullable": true
},
"createdDateTime": {
"type": "string",
"format": "date-time"
},
"modifiedBy": {
"type": "string",
"nullable": true
},
"modifiedDateTime": {
"type": "string",
"format": "date-time",
"nullable": true
},
"versionStamp": {
"type": "integer",
"format": "int32"
},
"documentsExists": {
"type": "boolean"
},
"enterInHours": {
"type": "boolean"
},
"active": {
"type": "boolean"
},
"negativeBalanceAllowed": {
"type": "boolean"
},
"qtyPayoutMax": {
"type": "number",
"format": "double"
},
"color": {
"type": "integer",
"format": "int32"
},
"visibleEmployeeDashboard": {
"type": "boolean",
"nullable": true
},
"visibleManagerDashboard": {
"type": "boolean",
"nullable": true
},
"visibleHrDashboard": {
"type": "boolean",
"nullable": true
},
"timeTrackingIntegrations": {
"type": "array",
"items": {
"$ref": "#/components/schemas/TimeTrackingIntegration"
},
"nullable": true
}
},
"additionalProperties": false
},
"TimeTrackingCodeIEnumerableODataResponse": {
"required": [
"value"
],
"type": "object",
"properties": {
"value": {
"type": "array",
"items": {
"$ref": "#/components/schemas/TimeTrackingCode"
},
"nullable": true
},
"@odata.context": {
"type": "string",
"nullable": true
},
"@odata.count": {
"type": "integer",
"format": "int32",
"nullable": true
},
"@odata.nextLink": {
"type": "string",
"nullable": true
}
},
"additionalProperties": false,
"description": "Represents a placeholder for describing OData responses."
},
"TimeTrackingGroup": {
"type": "object",
"properties": {
"timeTrackingGroupName": {
"type": "string",
"nullable": true
},
"rowNumber": {
"type": "integer",
"format": "int32"
},
"createdBy": {
"type": "string",
"nullable": true
},
"createdDateTime": {
"type": "string",
"format": "date-time"
},
"modifiedBy": {
"type": "string",
"nullable": true
},
"modifiedDateTime": {
"type": "string",
"format": "date-time",
"nullable": true
},
"versionStamp": {
"type": "integer",
"format": "int32"
},
"documentsExists": {
"type": "boolean"
},
"timeTrackingCodes": {
"type": "array",
"items": {
"$ref": "#/components/schemas/TimeTrackingCode"
},
"nullable": true
}
},
"additionalProperties": false
},
"TimeTrackingGroupIEnumerableODataResponse": {
"required": [
"value"
],
"type": "object",
"properties": {
"value": {
"type": "array",
"items": {
"$ref": "#/components/schemas/TimeTrackingGroup"
},
"nullable": true
},
"@odata.context": {
"type": "string",
"nullable": true
},
"@odata.count": {
"type": "integer",
"format": "int32",
"nullable": true
},
"@odata.nextLink": {
"type": "string",
"nullable": true
}
},
"additionalProperties": false,
"description": "Represents a placeholder for describing OData responses."
},
"TimeTrackingIEnumerableODataResponse": {
"required": [
"value"
],
"type": "object",
"properties": {
"value": {
"type": "array",
"items": {
"$ref": "#/components/schemas/TimeTracking"
},
"nullable": true
},
"@odata.context": {
"type": "string",
"nullable": true
},
"@odata.count": {
"type": "integer",
"format": "int32",
"nullable": true
},
"@odata.nextLink": {
"type": "string",
"nullable": true
}
},
"additionalProperties": false,
"description": "Represents a placeholder for describing OData responses."
},
"TimeTrackingIntegration": {
"type": "object",
"properties": {
"timeTrackingCode": {
"$ref": "#/components/schemas/TimeTrackingCode"
},
"timeTrackingCodeName": {
"type": "string",
"nullable": true
},
"version": {
"type": "integer",
"format": "int32"
},
"transDate": {
"type": "string",
"format": "date-time"
},
"balanceEffect": {
"type": "number",
"format": "double"
},
"nuisanceEffect": {
"type": "number",
"format": "double"
},
"employeeId": {
"type": "string",
"nullable": true
},
"payrollUpdateStatus": {
"type": "integer",
"format": "int32"
},
"payrollDateTime": {
"type": "string",
"format": "date-time",
"nullable": true
},
"rowNumber": {
"type": "integer",
"format": "int32"
},
"createdBy": {
"type": "string",
"nullable": true
},
"createdDateTime": {
"type": "string",
"format": "date-time"
},
"modifiedBy": {
"type": "string",
"nullable": true
},
"modifiedDateTime": {
"type": "string",
"format": "date-time",
"nullable": true
},
"versionStamp": {
"type": "integer",
"format": "int32"
},
"documentsExists": {
"type": "boolean"
},
"startTime": {
"type": "string",
"format": "date-time",
"nullable": true
},
"endTime": {
"type": "string",
"format": "date-time",
"nullable": true
},
"correction": {
"type": "boolean"
},
"hours": {
"type": "number",
"format": "double"
},
"timeTrackingId": {
"type": "string",
"nullable": true
},
"origin": {
"type": "integer",
"format": "int32"
},
"externalStatus": {
"type": "integer",
"format": "int32"
},
"employee": {
"$ref": "#/components/schemas/SimpleEmployee"
}
},
"additionalProperties": false
},
"TimeTrackingIntegrationIEnumerableODataResponse": {
"required": [
"value"
],
"type": "object",
"properties": {
"value": {
"type": "array",
"items": {
"$ref": "#/components/schemas/TimeTrackingIntegration"
},
"nullable": true
},
"@odata.context": {
"type": "string",
"nullable": true
},
"@odata.count": {
"type": "integer",
"format": "int32",
"nullable": true
},
"@odata.nextLink": {
"type": "string",
"nullable": true
}
},
"additionalProperties": false,
"description": "Represents a placeholder for describing OData responses."
}
},
"securitySchemes": {
"ApiKey-v2": {
"type": "apiKey",
"description": "Prefix the value with \"ApiKey-v2\" to indicate the custom authorization type",
"name": "Authorization",
"in": "header"
}
}
},
"security": [
{
"ApiKey-v2": [ ]
}
]
}