Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 7 additions & 7 deletions account/ip-restriction/v1/openapi.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ info:
version: "1.0"
title: Account IP Restriction API
description: |
The IP restriction API helps you managing your account and whitelisting your IPs and subnets for higher security when using your tyntec API key.
The IP restriction API helps you with managing your account and whitelisting your IPs and subnets for higher security when using your tyntec API key.

contact:
name: tyntec API Support
Expand Down Expand Up @@ -38,7 +38,7 @@ paths:
- ApiKeyHeader: []
operationId: ipRestrictionPOST
description: |
Modifies the IP whitelisting or this account. The operation is idempotent and will override the list of IPs and ranges that already exist.
Modifies the IP whitelisting for this account. The operation is idempotent and will override the list of IPs and ranges that already exist.
responses:
"200":
description: The IP whitelist as modified by this request.
Expand All @@ -47,7 +47,7 @@ paths:
schema:
$ref: "#/components/schemas/IpRestrictionEntity"
"400":
description: Invalid request
description: An invalid request
content:
application/json:
schema:
Expand All @@ -71,7 +71,7 @@ paths:
schema:
$ref: "#/components/schemas/Problem"
requestBody:
description: IP restriction whitelist
description: An IP restriction whitelist
required: true
content:
application/json:
Expand All @@ -94,7 +94,7 @@ paths:
schema:
$ref: "#/components/schemas/IpRestrictionEntity"
"400":
description: Invalid request
description: An invalid request
content:
application/json:
schema:
Expand Down Expand Up @@ -160,15 +160,15 @@ components:
example: https://docs.tyntec.com/problems/DataNotParseable
type: string
title:
description: Short, human-readable summary of the problem type
description: A short, human-readable summary of the problem type
type: string
example: The given data were not parsable.
status:
description: The HTTP status code (RFC7231, Section 6) generated by the origin server for this occurrence of the problem
type: string
example: 400
detail:
description: Human-readable explanation specific to this problem occurrence
description: A human-readable explanation specific to this problem occurrence
type: string
example: |
Unexpected end-of-input: expected close marker for Object (start marker at [Source: UNKNOWN; line: -1, column: -1) at [Source: UNKNOWN; line: 1, column: 97]
20 changes: 10 additions & 10 deletions account/keys/v1/openapi.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ info:
version: "1.0"
title: Account Keys API
description: |
The keys API helps you managing your account API keys. You can add a secondary key for your account and delete the old one. With this mechanism you can safely rotate a key, on runtime, to keep your account safe.
The keys API helps you with managing your account API keys. You can add a secondary key to your account and delete the old one. With this mechanism you can safely rotate a key, on runtime, to keep your account safe.
contact:
name: tyntec API Support
url: http://www.tyntec.com/support
Expand All @@ -17,16 +17,16 @@ security:
tags:
- name: Account keys
description: |
tyntec’s account keys service allow you to:
tyntec’s account keys service allows you to:

- Add a secondary authentication token key on your account. Both keys (old and new) will be valid and active.
- You can delete the old key once your new key is replaced at your systems.
- Add a secondary authentication token key to your account. Both keys (old and new) will be valid and active.
- You can delete the old key once your new key is replaced in your systems.

**Important**

You can not delete the key you are using for this API call.

Once a key is deleted, this will have immediate effect and no recovery is possible.
Once a key is deleted, this will have an immediate effect and no recovery is possible.
paths:
/account/v1/keys:
get:
Expand All @@ -46,7 +46,7 @@ paths:
schema:
$ref: "#/components/schemas/ApiKeyResponse"
"400":
description: Invalid request
description: An invalid request
content:
application/json:
schema:
Expand Down Expand Up @@ -86,7 +86,7 @@ paths:
schema:
$ref: "#/components/schemas/ApiKeyResponse"
"400":
description: Invalid request
description: An invalid request
content:
application/json:
schema:
Expand Down Expand Up @@ -138,7 +138,7 @@ paths:
schema:
$ref: "#/components/schemas/ApiKeyResponse"
"400":
description: Invalid request
description: An invalid request
content:
application/json:
schema:
Expand Down Expand Up @@ -210,15 +210,15 @@ components:
example: https://docs.tyntec.com/problems/DataNotParseable
type: string
title:
description: Short, human-readable summary of the problem type
description: A short, human-readable summary of the problem type
type: string
example: The given data were not parsable.
status:
description: The HTTP status code (RFC7231, Section 6) generated by the origin server for this occurrence of the problem
type: string
example: 400
detail:
description: Human-readable explanation specific to this problem occurrence
description: A human-readable explanation specific to this problem occurrence
type: string
example: |
Unexpected end-of-input: expected close marker for Object (start marker at [Source: UNKNOWN; line: -1, column: -1) at [Source: UNKNOWN; line: 1, column: 97]
Loading