PRM_Software_AG/api-documentation
12
1
Fork 0
Code Issues 10 Pull Requests Activity

Compare commits

base: PRM_Software_AG:adb589ef49aaac5a2d39366615e8802bf10c23d6
Branches Tags
PRM_Software_AG:master PRM_Software_AG:development
..
compare: PRM_Software_AG:master
Branches Tags
PRM_Software_AG:master PRM_Software_AG:development

5 Commits
adb589ef49 ... master

Author SHA1 Message Date
Nico Kroll
eb8630ff24 New Endpoint /Filters2, to make implementation easier 2026-04-09 14:34:58 +02:00
Nico Kroll
2960d1bd36 Each branch has now hints 2026-02-24 09:41:23 +01:00
Nico Kroll
6eda09efbe More fields and some bugfixes 2026-01-30 07:45:25 +01:00
Nico Kroll
dc1751b852 Update README.md 2026-01-30 07:44:50 +01:00
Nico Kroll
760da37fe3 Methods to search the exact predecessor and successor 2026-01-30 07:44:48 +01:00
4 changed files with 227 additions and 34 deletions
Expand all files Collapse all files

1
docs/README.md
View File

@@ -27,3 +27,4 @@ https://docs.hetzner.cloud/
https://opensource.zalando.com/restful-api-guidelines https://opensource.zalando.com/restful-api-guidelines
https://kubernetes.io/docs/reference/using-api/api-concepts https://kubernetes.io/docs/reference/using-api/api-concepts
https://docs.stripe.com/api/prices https://docs.stripe.com/api/prices
https://developer.clickup.com/docs/authentication

17
src/v1/openapi.yaml
View File

@@ -4193,6 +4193,7 @@ components:
- "GuidOnlineSchedulerService" - "GuidOnlineSchedulerService"
- "GuidBranch" - "GuidBranch"
- "IsDefault" - "IsDefault"
- "Hints"
properties: properties:
Guid: Guid:
type: "string" type: "string"
@@ -4202,6 +4203,22 @@ components:
type: "string" type: "string"
IsDefault: IsDefault:
type: "string" type: "string"
Hints:
type: "array"
items:
type: "object"
required:
- "AttentionLevel"
- "Hint"
properties:
AttentionLevel:
type: "string"
enum:
- "Low"
- "Mid"
- "High"
Hint:
type: "string"
_HashValue: _HashValue:
$ref: "#/components/schemas/_HashValue" $ref: "#/components/schemas/_HashValue"
example: example:

209
src/v2/shop.yaml
View File

@@ -1,7 +1,7 @@
openapi: 3.0.0 openapi: 3.0.0
info: info:
title: "TyrePro-API, Shop" title: "TyrePro-API, Shop"
version: "Version 16" version: "Version 19"
servers: servers:
- url: "https://musterreifen.com/api/shop" - url: "https://musterreifen.com/api/shop"
description: "Development server, customers domain" description: "Development server, customers domain"
@@ -500,6 +500,62 @@ paths:
- "HoleCircle2" - "HoleCircle2"
- "Offset2" - "Offset2"
- "HubBoreHole2" - "HubBoreHole2"
- name: "MaximumNumberOfOptions"
in: "query"
required: false
schema:
type: "integer"
default: 1000
example: 1000
responses:
200:
description: "successful operation"
headers:
Developer-Hint:
schema:
type: "string"
description: "To prevent data intense calls, we may manipulate your request. If so, you get a hint here, what exactly we've done."
content:
application/json:
schema:
type: "array"
items:
$ref: "#/components/schemas/Filter"
default:
$ref: "#/components/responses/GenericError"
security:
- SessionScheme: []
/Filters2:
get:
tags:
- "Search"
parameters:
- $ref: "#/components/parameters/GuidOnlineService"
- $ref: "#/components/parameters/GuidBranch"
- $ref: "#/components/parameters/SearchTerm1"
- $ref: "#/components/parameters/SearchTerm2"
- $ref: "#/components/parameters/GuidMaterialType"
- $ref: "#/components/parameters/GuidVehicleType"
- $ref: "#/components/parameters/GuidWidth"
- $ref: "#/components/parameters/GuidSection"
- $ref: "#/components/parameters/GuidDiameter"
- $ref: "#/components/parameters/GuidSpeedIndex"
- $ref: "#/components/parameters/GuidLoadIndex"
- $ref: "#/components/parameters/GuidHoleCount"
- $ref: "#/components/parameters/GuidHoleCircle"
- $ref: "#/components/parameters/GuidOffset"
- $ref: "#/components/parameters/GuidHubBoreHole"
- $ref: "#/components/parameters/GuidManufacturer"
- $ref: "#/components/parameters/GuidMotorcycleManufacturer"
- $ref: "#/components/parameters/GuidMotorcycleDisplacement"
- $ref: "#/components/parameters/GuidMotorcycleModel"
- name: "MaximumNumberOfOptions"
in: "query"
required: false
schema:
type: "integer"
default: 200
example: 200
responses: responses:
200: 200:
description: "successful operation" description: "successful operation"
@@ -508,7 +564,7 @@ paths:
schema: schema:
type: "array" type: "array"
items: items:
$ref: "#/components/schemas/Filter" $ref: "#/components/schemas/Filter2"
default: default:
$ref: "#/components/responses/GenericError" $ref: "#/components/responses/GenericError"
security: security:
@@ -666,11 +722,6 @@ paths:
responses: responses:
200: 200:
description: "successful operation" description: "successful operation"
headers:
Guid-Shop-Article-Config:
schema:
type: "string"
description: "The ShopArticleConfig which was used to build the response. With this unification the configuration is maybe not precise, but you can show the results in a unified form (columns). Currently it's a response header. In the future we will maybe change this as a field in a response object."
content: content:
application/json: application/json:
schema: schema:
@@ -714,11 +765,6 @@ paths:
responses: responses:
200: 200:
description: "successful operation" description: "successful operation"
headers:
Guid-Shop-Article-Config:
schema:
type: "string"
description: "The ShopArticleConfig which was used to build the response. With this unification the configuration is maybe not precise, but you can show the results in a unified form (columns). Currently it's a response header. In the future we will maybe change this as a field in a response object."
content: content:
application/json: application/json:
schema: schema:
@@ -738,6 +784,13 @@ paths:
- $ref: "#/components/parameters/BinaryObjectContentType" - $ref: "#/components/parameters/BinaryObjectContentType"
- $ref: "#/components/parameters/GuidShopArticle" - $ref: "#/components/parameters/GuidShopArticle"
- $ref: "#/components/parameters/GuidMotorcycleModel" - $ref: "#/components/parameters/GuidMotorcycleModel"
- name: "GuidShopArticle2"
in: "query"
required: false
schema:
type: "string"
default: null
example: "ebb89e89-8d25-809e-7814-c53b686ae164"
responses: responses:
200: 200:
description: "successful operation" description: "successful operation"
@@ -1335,6 +1388,7 @@ components:
- "Designation" - "Designation"
- "Number" - "Number"
- "IsActive" - "IsActive"
- "DefaultDeliveryDate"
properties: properties:
Guid: Guid:
type: "string" type: "string"
@@ -1356,6 +1410,9 @@ components:
type: "number" type: "number"
Longitude: Longitude:
type: "number" type: "number"
DefaultDeliveryDate:
type: "string"
format: "date"
example: example:
Guid: "ebb89e89-8d25-809e-7814-c53b686ae164" Guid: "ebb89e89-8d25-809e-7814-c53b686ae164"
Designation: "Zentrale" Designation: "Zentrale"
@@ -1408,9 +1465,16 @@ components:
type: "object" type: "object"
required: required:
- "Guid" - "Guid"
- "DesiredAmountOfDirectSearch"
- "DesiredAmountOfCombinationSearch"
- "Columns"
properties: properties:
Guid: Guid:
type: "string" type: "string"
DesiredAmountOfDirectSearch:
type: "number"
DesiredAmountOfCombinationSearch:
type: "number"
Columns: Columns:
type: "array" type: "array"
items: items:
@@ -1474,34 +1538,44 @@ components:
type: "string" type: "string"
GuidVehicleType: GuidVehicleType:
type: "string" type: "string"
Types: TypeGroups:
type: "array" type: "array"
items: items:
type: "object" type: "object"
required: required:
- "Designation" - "Designation"
- "Type" - "Types"
properties: properties:
Designation: Designation:
type: "string" type: "string"
Type: Types:
type: "string" type: "array"
enum: items:
- "MaterialType" type: "object"
- "VehicleType" required:
- "Width" - "Designation"
- "Section" - "Type"
- "Diameter" properties:
- "SpeedIndex" Designation:
- "LoadIndex" type: "string"
- "HoleCount" Type:
- "HoleCircle" type: "string"
- "Offset" enum:
- "HubBoreHole" - "MaterialType"
- "Manufacturer" - "VehicleType"
- "MotorcycleManufacturer" - "Width"
- "MotorcycleDisplacement" - "Section"
- "MotorcycleModel" - "Diameter"
- "SpeedIndex"
- "LoadIndex"
- "HoleCount"
- "HoleCircle"
- "Offset"
- "HubBoreHole"
- "Manufacturer"
- "MotorcycleManufacturer"
- "MotorcycleDisplacement"
- "MotorcycleModel"
Filter: Filter:
type: "object" type: "object"
required: required:
@@ -1556,6 +1630,68 @@ components:
type: "string" type: "string"
ParameterValue: ParameterValue:
type: "string" type: "string"
Filter2:
type: "object"
required:
- "Type"
- "Designation"
- "Fields"
properties:
Type:
type: "string"
enum:
- "Basic"
- "Detail"
- "Motorcycle"
Designation:
type: "string"
Fields:
type: "array"
items:
type: "object"
required:
- "Type"
- "Designation"
- "ParameterKey"
- "Options"
properties:
Type:
type: "string"
enum:
- "MaterialType"
- "VehicleType"
- "Width"
- "Section"
- "Diameter"
- "SpeedIndex"
- "LoadIndex"
- "HoleCount"
- "HoleCircle"
- "Offset"
- "HubBoreHole"
- "Manufacturer"
- "MotorcycleManufacturer"
- "MotorcycleDisplacement"
- "MotorcycleModel"
Designation:
type: "string"
ParameterKey:
type: "string"
Options:
type: "array"
items:
type: "object"
required:
- "Designation"
- "NumberOfResults"
- "ParameterValue"
properties:
Designation:
type: "string"
NumberOfResults:
type: "integer"
ParameterValue:
type: "string"
ShopArticle: ShopArticle:
type: "object" type: "object"
required: required:
@@ -1861,6 +1997,7 @@ components:
- "Guid" - "Guid"
- "GuidCurrency" - "GuidCurrency"
- "DefaultAmount" - "DefaultAmount"
- "DefaultDeliveryDate"
- "OneClickPurchase" - "OneClickPurchase"
- "FullTaxPercentage" - "FullTaxPercentage"
- "ReducedTaxPercentage" - "ReducedTaxPercentage"
@@ -1886,6 +2023,10 @@ components:
DefaultAmount: DefaultAmount:
type: "number" type: "number"
readOnly: true readOnly: true
DefaultDeliveryDate:
type: "string"
format: "date"
readOnly: true
OneClickPurchase: OneClickPurchase:
type: "boolean" type: "boolean"
readOnly: true readOnly: true
@@ -2341,8 +2482,8 @@ components:
type: "string" type: "string"
default: null default: null
example: "ebb89e89-8d25-809e-7814-c53b686ae164" example: "ebb89e89-8d25-809e-7814-c53b686ae164"
SearchTerm: SearchTerm1:
name: "SearchTerm" name: "SearchTerm1"
in: "query" in: "query"
required: false required: false
schema: schema:

34
src/v2/tpms.yaml
View File

@@ -167,6 +167,23 @@ paths:
$ref: "#/components/responses/GenericError" $ref: "#/components/responses/GenericError"
security: security:
- SessionScheme: [] - SessionScheme: []
/CustomerStorages/{Guid}/custommethods/Predecessor:
get:
tags:
- "TPMS / customer storage"
parameters:
- $ref: "#/components/parameters/GuidPathParameter"
responses:
200:
description: "successful operation"
content:
application/json:
schema:
$ref: "#/components/schemas/CustomerStorage"
default:
$ref: "#/components/responses/GenericError"
security:
- SessionScheme: []
/CustomerStorages/{Guid}/custommethods/Rearrange: /CustomerStorages/{Guid}/custommethods/Rearrange:
post: post:
tags: tags:
@@ -184,6 +201,23 @@ paths:
$ref: "#/components/responses/GenericError" $ref: "#/components/responses/GenericError"
security: security:
- SessionScheme: [] - SessionScheme: []
/CustomerStorages/{Guid}/custommethods/Successor:
get:
tags:
- "TPMS / customer storage"
parameters:
- $ref: "#/components/parameters/GuidPathParameter"
responses:
200:
description: "successful operation"
content:
application/json:
schema:
$ref: "#/components/schemas/CustomerStorage"
default:
$ref: "#/components/responses/GenericError"
security:
- SessionScheme: []
/CustomerStoragePositions/{Guid}: /CustomerStoragePositions/{Guid}:
get: get:
tags: tags: