Skip to content

Ping

GET
/api/managing-entity/{managingEntityIdentifier}/channel-manager/ping
curl --request GET \
--url https://integrations.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/channel-manager/ping \
--header 'Authorization: Bearer <token>' \
--header 'Wink-Version: 2.0'

Health-check endpoint that validates your credentials and returns the API version plus your account’s name and status.

managingEntityIdentifier
required
string
""

Rate provider (channel-manager account) identifier (UUID)

Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69
Wink-Version
string
default: 2.0.0
Allowed values: 2.0

Credentials are valid; returns API version plus account name and status

Media typeapplication/json

Response returned by the ping endpoint confirming that credentials are valid

object
apiVersion
required

API version

string
""
name
required

Account name

string
""
status
required

Account status. PENDING_APPROVAL: awaiting admin activation; ACTIVE: account is operational; INACTIVE: account has been deactivated; UNDER_REVIEW: account is being reviewed; SUSPENDED: account suspended due to policy violation; REJECTED: account application was rejected; REMOVED: account has been deleted

string
""
Allowed values: PENDING_APPROVAL ACTIVE INACTIVE UNDER_REVIEW SUSPENDED REJECTED REMOVED
key
additional properties
""
Example
{
"apiVersion": "2.0",
"name": "The Siam Residences, Bangkok"
}

Bad Request — missing or invalid request parameter or body

Media typeapplication/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

Unauthorized — authentication is required or the session has expired

Media typeapplication/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

Forbidden — authenticated but lacking the required permission or scope

Media typeapplication/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

Not Found — the requested resource does not exist

Media typeapplication/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

Method Not Allowed — the HTTP verb is not supported on this endpoint

Media typeapplication/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

Unsupported Media Type — use application/json

Media typeapplication/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

Internal Server Error — an unexpected failure occurred on the server

Media typeapplication/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

Service Unavailable — a downstream dependency is unreachable

Media typeapplication/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example