API docs by Redocly

Cosmo Points (1.0.0)

Download OpenAPI specification:Download

Welcome to the Cosmo Points API documentation. The service simplifies interactions by aggregating different APIs into a single, consistent interface. It supports point-to-point and point-to-gift card redemption and conversion, offering an efficient way to manage and exchange points across multiple platforms

Relay

Authentication

Before starting using the Relay APIs, you need to authenticate yourself.

  • This API uses Bearer token for authentication.
  • Every token is valid for 10 minutes.
  • Token MUST be provided in Authorization header, in string Bearer plus a token format, which can be obtained by the login service.
Request Body schema: application/json
required
clientId
string
clientSecret
string

Responses

Request samples

Content type
application/json
{
  • "clientId": "string",
  • "clientSecret": "string"
}

Response samples

Content type
application/json
{
  • "token": "string"
}

Issue Points

Issue points with a specified partner

Authorizations:
jwtAuth
Request Body schema: application/json
required
partner
string
amount
integer

Responses

Request samples

Content type
application/json
{
  • "partner": "string",
  • "amount": 0
}

Issue Gift Cards

Issue a gift card with a specified partner

Authorizations:
jwtAuth
Request Body schema: application/json
required
partner
string
amount
integer
giftCardId
string

Responses

Request samples

Content type
application/json
{
  • "partner": "string",
  • "amount": 0,
  • "giftCardId": "string"
}