Skip to content

Commit 5b98b89

Browse files
automation-commercetoolsautomation-commercetools
committed
TASK: updating OAS and Postman definition
1 parent 3932b70 commit 5b98b89

File tree

3 files changed

+951
-1
lines changed

3 files changed

+951
-1
lines changed

‎api.swagger.json‎

Lines changed: 299 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -104,6 +104,89 @@
104104
"action"
105105
]
106106
},
107+
"ApiClient": {
108+
"title": "ApiClient",
109+
"type": "object",
110+
"properties": {
111+
"id": {
112+
"type": "string"
113+
},
114+
"name": {
115+
"type": "string"
116+
},
117+
"scope": {
118+
"type": "string"
119+
},
120+
"createdAt": {
121+
"type": "string",
122+
"format": "date-time"
123+
},
124+
"lastUsedAt": {
125+
"type": "string",
126+
"format": "date"
127+
},
128+
"secret": {
129+
"type": "string"
130+
}
131+
},
132+
"required": [
133+
"id",
134+
"name",
135+
"scope",
136+
"createdAt",
137+
"lastUsedAt"
138+
],
139+
"x-annotation-package": "ApiClient",
140+
"x-annotation-docs-uri": "https://docs.commercetools.com/http-api-projects-apiClients.html#apiclient"
141+
},
142+
"ApiClientDraft": {
143+
"title": "ApiClientDraft",
144+
"type": "object",
145+
"properties": {
146+
"name": {
147+
"type": "string"
148+
},
149+
"scope": {
150+
"type": "string"
151+
}
152+
},
153+
"required": [
154+
"name",
155+
"scope"
156+
],
157+
"x-annotation-package": "ApiClient",
158+
"x-annotation-docs-uri": "https://docs.commercetools.com/http-api-projects-apiClients.html#apiclientdraft"
159+
},
160+
"ApiClientPagedQueryResponse": {
161+
"title": "ApiClientPagedQueryResponse",
162+
"type": "object",
163+
"properties": {
164+
"count": {
165+
"format": "int64",
166+
"type": "number"
167+
},
168+
"total": {
169+
"format": "int64",
170+
"type": "number"
171+
},
172+
"offset": {
173+
"format": "int64",
174+
"type": "number"
175+
},
176+
"results": {
177+
"type": "array",
178+
"items": {
179+
"$ref": "#/definitions/ApiClient"
180+
}
181+
}
182+
},
183+
"required": [
184+
"count",
185+
"offset",
186+
"results"
187+
],
188+
"x-annotation-package": "ApiClient"
189+
},
107190
"CartDiscount": {
108191
"title": "CartDiscount",
109192
"allOf": [
@@ -39652,6 +39735,222 @@
3965239735
}
3965339736
],
3965439737
"x-annotation-methodName": "withId"
39738+
},
39739+
"/{projectKey}/api-clients": {
39740+
"get": {
39741+
"description": "Query api-clients",
39742+
"operationId": "GET_projectKey-api-clients",
39743+
"responses": {
39744+
"200": {
39745+
"$ref": "#/responses/trait:deprecatable:200"
39746+
},
39747+
"400": {
39748+
"$ref": "#/responses/trait:errorable:400"
39749+
},
39750+
"404": {
39751+
"$ref": "#/responses/trait:errorable:404"
39752+
},
39753+
"500": {
39754+
"$ref": "#/responses/trait:errorable:500"
39755+
},
39756+
"503": {
39757+
"$ref": "#/responses/trait:errorable:503"
39758+
}
39759+
},
39760+
"parameters": [
39761+
{
39762+
"description": "If queries support ad-hoc filtering of resources through flexible predicates, they do so via the where query\nparameter that accepts a single (possibly compound) predicate to determine whether a specific resource\nrepresentation should be included in the result.\n\nThe structure of predicates and the names of the fields follow the structure and naming of the fields in the\ndocumented response representation of the query results.\n\nExamples of predicates:\n\n // Compare a field's value to a given value\n name = \"Peter\"\n age < 42\n age > 42\n age <= 42\n age >= 42\n age <> 42\n\n // Combine any two conditional expressions in a logical conjunction / disjunction\n name = \"Peter\" and age < 42\n name = \"Peter\" or age < 42\n\n // Negate any other conditional expression\n not (name = \"Peter\" and age < 42)\n\n // Check whether a field's value is or is not contained in\n // a specified set of values.\n age in (42, 43, 44)\n age not in (42, 43, 44)\n\n // Check whether an array contains all or any of a set of values\n tags contains all (\"a\", \"b\", \"c\")\n tags contains any (\"a\", \"b\", \"c\")\n\n // Check whether an array is empty\n tags is empty\n\n // Check whether a field exists & has a non-null value\n name is defined\n name is not defined\n\n // Descend into nested objects\n dog(age < 7 and name = \"Beethoven\")\n\n // Descend into nested arrays of objects\n cities(zip > 10000 and zip < 20000)\n\nA query endpoint usually restricts predicates to only be allowed on a specified subset of a resource\nrepresentation's fields. The documentation of the endpoint will therefore list fields that can be used\nfor constructing predicates.\n\nIf multiple predicates are specified via multiple where query parameters, the individual predicates are\ncombined in a logical conjunction, just as if they had been specified in a single where query parameter\nand combined with and.\n\nNote: The encoding of the predicates is UTF-8 and the predicate must be URL-encoded in the HTTP request.\n",
39763+
"type": "string",
39764+
"in": "query",
39765+
"name": "where"
39766+
},
39767+
{
39768+
"description": "A query endpoint that supports sorting does so through the sort query parameter. The provided value must be\na valid sort expression. The default sort direction is ASC. The allowed sort paths are typically listed on\nthe specific query endpoints.\n\nHere are some examples of sort expressions:\n\n name desc\n dog.age asc\n\nIf multiple sort expressions are specified via multiple sort parameters, they are combined into a composed\nsort where the results are first sorted by the first expression, followed by equal values being sorted\naccording to the second expression, and so on.\n\nNote: The sorting is case sensitive.\n",
39769+
"type": "string",
39770+
"in": "query",
39771+
"name": "sort"
39772+
},
39773+
{
39774+
"$ref": "#/parameters/trait:expandable:expand"
39775+
},
39776+
{
39777+
"$ref": "#/parameters/trait:paging:limit"
39778+
},
39779+
{
39780+
"$ref": "#/parameters/trait:paging:offset"
39781+
},
39782+
{
39783+
"$ref": "#/parameters/trait:paging:withTotal"
39784+
}
39785+
],
39786+
"security": [
39787+
{
39788+
"oauth_2_0": [
39789+
"manage_api_clients:{projectKey}",
39790+
"view_api_clients:{projectKey}"
39791+
]
39792+
}
39793+
]
39794+
},
39795+
"post": {
39796+
"description": "Create ApiClient",
39797+
"operationId": "POST_projectKey-api-clients",
39798+
"responses": {
39799+
"200": {
39800+
"$ref": "#/responses/trait:deprecatable:200"
39801+
},
39802+
"201": {
39803+
"description": "",
39804+
"examples": {
39805+
"application/json": {
39806+
"id": "api-client-id",
39807+
"name": "api-client-name",
39808+
"scope": "view_products",
39809+
"createdAt": "2018-01-01T00:00:00.001Z",
39810+
"lastUsedAt": "2017-9-10",
39811+
"secret": "secret-passphrase"
39812+
}
39813+
},
39814+
"schema": {
39815+
"$ref": "#/definitions/ApiClient"
39816+
}
39817+
},
39818+
"400": {
39819+
"$ref": "#/responses/trait:errorable:400"
39820+
},
39821+
"404": {
39822+
"$ref": "#/responses/trait:errorable:404"
39823+
},
39824+
"500": {
39825+
"$ref": "#/responses/trait:errorable:500"
39826+
},
39827+
"503": {
39828+
"$ref": "#/responses/trait:errorable:503"
39829+
}
39830+
},
39831+
"parameters": [
39832+
{
39833+
"schema": {
39834+
"example": {
39835+
"name": "api-client-name",
39836+
"scope": "view_products"
39837+
},
39838+
"$ref": "#/definitions/ApiClientDraft"
39839+
},
39840+
"in": "body",
39841+
"name": "body",
39842+
"required": true
39843+
},
39844+
{
39845+
"$ref": "#/parameters/trait:expandable:expand"
39846+
}
39847+
],
39848+
"security": [
39849+
{
39850+
"oauth_2_0": [
39851+
"manage_api_clients:{projectKey}"
39852+
]
39853+
}
39854+
]
39855+
},
39856+
"parameters": [
39857+
{
39858+
"type": "string",
39859+
"in": "path",
39860+
"name": "projectKey",
39861+
"required": true
39862+
}
39863+
]
39864+
},
39865+
"/{projectKey}/api-clients/{ID}": {
39866+
"get": {
39867+
"description": "Get ApiClient by ID",
39868+
"operationId": "GET_projectKey-api-clients-ID",
39869+
"responses": {
39870+
"200": {
39871+
"$ref": "#/responses/trait:deprecatable:200"
39872+
},
39873+
"400": {
39874+
"$ref": "#/responses/trait:errorable:400"
39875+
},
39876+
"404": {
39877+
"$ref": "#/responses/trait:errorable:404"
39878+
},
39879+
"500": {
39880+
"$ref": "#/responses/trait:errorable:500"
39881+
},
39882+
"503": {
39883+
"$ref": "#/responses/trait:errorable:503"
39884+
}
39885+
},
39886+
"parameters": [
39887+
{
39888+
"$ref": "#/parameters/trait:expandable:expand"
39889+
}
39890+
],
39891+
"security": [
39892+
{
39893+
"oauth_2_0": [
39894+
"manage_api_clients:{projectKey}",
39895+
"view_api_clients:{projectKey}"
39896+
]
39897+
}
39898+
]
39899+
},
39900+
"delete": {
39901+
"description": "Delete ApiClient by ID",
39902+
"operationId": "DELETE_projectKey-api-clients-ID",
39903+
"responses": {
39904+
"200": {
39905+
"$ref": "#/responses/trait:deprecatable:200"
39906+
},
39907+
"400": {
39908+
"$ref": "#/responses/trait:errorable:400"
39909+
},
39910+
"404": {
39911+
"$ref": "#/responses/trait:errorable:404"
39912+
},
39913+
"409": {
39914+
"$ref": "#/responses/trait:conflicting:409"
39915+
},
39916+
"500": {
39917+
"$ref": "#/responses/trait:errorable:500"
39918+
},
39919+
"503": {
39920+
"$ref": "#/responses/trait:errorable:503"
39921+
}
39922+
},
39923+
"parameters": [
39924+
{
39925+
"$ref": "#/parameters/trait:versioned:version"
39926+
},
39927+
{
39928+
"$ref": "#/parameters/trait:expandable:expand"
39929+
}
39930+
],
39931+
"security": [
39932+
{
39933+
"oauth_2_0": [
39934+
"manage_api_clients:{projectKey}"
39935+
]
39936+
}
39937+
]
39938+
},
39939+
"parameters": [
39940+
{
39941+
"type": "string",
39942+
"in": "path",
39943+
"name": "ID",
39944+
"required": true
39945+
},
39946+
{
39947+
"type": "string",
39948+
"in": "path",
39949+
"name": "projectKey",
39950+
"required": true
39951+
}
39952+
],
39953+
"x-annotation-methodName": "withId"
3965539954
}
3965639955
}
3965739956
}

0 commit comments

Comments
 (0)