SpotLite sites api (0.5.0)

Download OpenAPI specification:

Pages

Pages_create

Creates a new page for the selected clientId. This page won't be published until a domain is purchased.

Authorizations:
BearerAuth
Request Body schema: application/json
required

Page object

clientId
required
string [ 5 .. 50 ] characters

Client ID

templateId
required
string

Template ID. This will be obtained from the templates endpoint

scriptUrl
string <uri>

Custom script URL. The script will be loaded at the end of the page

required
object

Profile information

required
Array of objects (LinkSectionSchema) non-empty

Ordered list of sections

object

Footer information

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{}

Pages_listPages

List the pages that belong to a client

Authorizations:
BearerAuth
query Parameters
clientId
required
string

Unique client idendificator. This client id is the owner of the pages.

Responses

Response samples

Content type
application/json
[]

Pages_listTemplates

Authorizations:
BearerAuth

Responses

Response samples

Content type
application/json

Pages_getPage

Authorizations:
BearerAuth
path Parameters
id
required
string (pageId)
Example: 67ee01ffd87a29376aeb52b1

Unique ID of the page

Responses

Response samples

Content type
application/json
{}

Versions_listVersions

Get the list of versions for a page

Authorizations:
BearerAuth
path Parameters
id
required
string (pageId)
Example: 67ee01ffd87a29376aeb52b1

Page ID

query Parameters
status
string (SiteStatus)
Enum: "Preview" "Published"

Optional. Filter by status

Responses

Response samples

Content type
application/json
[]

Versions_createVersion

Creates a new preview version of the page. This will not change the current published version.

Authorizations:
BearerAuth
path Parameters
id
required
string (pageId)
Example: 67ee01ffd87a29376aeb52b1

Page ID

Request Body schema: application/json
required

Full page object (this endpoint won't merge data with the existing page)

clientId
required
string [ 5 .. 50 ] characters

Client ID

templateId
required
string

Template ID. This will be obtained from the templates endpoint

scriptUrl
string <uri>

Custom script URL. The script will be loaded at the end of the page

required
object

Profile information

required
Array of objects (LinkSectionSchema) non-empty

Ordered list of sections

object

Footer information

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{}

Versions_getVersion

Get a specific version of the page

Authorizations:
BearerAuth
path Parameters
id
required
string (pageId)
Example: 67ee01ffd87a29376aeb52b1

Page ID

versionId
required
string

Version ID

Responses

Response samples

Content type
application/json
{}

Versions_updateVersion

Updates a specific version of the page

Authorizations:
BearerAuth
path Parameters
id
required
string (pageId)
Example: 67ee01ffd87a29376aeb52b1

Page ID

versionId
required
string

Version ID

Request Body schema: application/json
required
clientId
required
string [ 5 .. 50 ] characters

Client ID

templateId
required
string

Template ID. This will be obtained from the templates endpoint

scriptUrl
string <uri>

Custom script URL. The script will be loaded at the end of the page

required
object

Profile information

required
Array of objects (LinkSectionSchema) non-empty

Ordered list of sections

object

Footer information

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{}

Versions_publish

Publishes a specific page version content replacing the current published version.

This operation will only succeed if the page has a domain associated with it.

Authorizations:
BearerAuth
path Parameters
id
required
string (pageId)
Example: 67ee01ffd87a29376aeb52b1

Page ID

versionId
required
string

Version ID

Responses

Response samples

Content type
application/json
{
  • "code": "PUBLISHING_ERROR",
  • "message": "The page does not have a domain associated with it"
}

Versions_startUpload

Starts the image upload process for the page. This will return a signed URL to upload the image to the CDN.

This operation will immediately update the page preview with the new image URL (will show a default image until the actual upload is completed).

Any publihsed version will not be affected by this operation.

Authorizations:
BearerAuth
path Parameters
id
required
string (pageId)
Example: 67ee01ffd87a29376aeb52b1

Page ID

versionId
required
string

Version ID

Responses

Page Domain

Domains_getDomain

Get the details of domain assigned to the page

Authorizations:
BearerAuth
path Parameters
id
required
string (pageId)
Example: 67ee01ffd87a29376aeb52b1

Unique ID of the page

Responses

Response samples

Content type
application/json
{
  • "name": "jd-notary.pro",
  • "status": "Registered",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "expireDate": "2019-08-24T14:15:22Z",
  • "renewalPrice": 0.1
}

Domains_checkAvailability

Check the availability of a domain. The service will only check tlds that are supported by the service.

Authorizations:
BearerAuth
path Parameters
id
required
string (pageId)
Example: 67ee01ffd87a29376aeb52b1

Unique ID of the page

query Parameters
domain
required
string

Domain name

Responses

Response samples

Content type
application/json
{
  • "name": "jd-notary.pro",
  • "available": true,
  • "purchasePrice": 0.1,
  • "renewalPrice": 0.1
}

Domains_registerDomain

Register a domain for the page

Authorizations:
BearerAuth
path Parameters
id
required
string (pageId)
Example: 67ee01ffd87a29376aeb52b1

Unique ID of the page

Request Body schema: text/plain
required

Domain name

string

Responses

Response samples

Content type
application/json
{
  • "code": "REGISTRATION_ERROR",
  • "message": "The specified domain is already registered"
}

Domains_searchDomain

Search for available domains.

This will return a list of available domains based on the search query and the pages profile information.

The service will only return tlds that are supported by the service.

Authorizations:
BearerAuth
path Parameters
id
required
string (pageId)
Example: 67ee01ffd87a29376aeb52b1

Unique ID of the page

query Parameters
domain
required
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Domains_streamSearchDomain

Search for available domains.

This will stream a list of available domains based on the search query and the pages profile information.

The service will only return tlds that are supported by the service.

Authorizations:
BearerAuth
path Parameters
id
required
string (pageId)
Example: 67ee01ffd87a29376aeb52b1

Unique ID of the page

query Parameters
domain
required
string

Responses

Response samples

Content type
application/json
{
  • "code": 400,
  • "message": "Invalid request"
}

Email Forwarding

emailForwarding_setupEmailForwarding

Setup email forwarding for the page

This will forward all emails sent to the new email address to the existing email address.

Authorizations:
BearerAuth
path Parameters
id
required
string (pageId)
Example: 67ee01ffd87a29376aeb52b1

Unique ID of the page

Request Body schema: application/json
required

Email forwarding details

emailBox
required
string

New email address will be emailBox@page-domain. e.g. john.doe@jd-notary.pro

emailForwardTo
required
string <email>

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "code": 400,
  • "message": "Invalid request"
}

emailForwarding_listEmailForwarding

List all email forwarding details for the page

Authorizations:
BearerAuth
path Parameters
id
required
string (pageId)
Example: 67ee01ffd87a29376aeb52b1

Unique ID of the page

Responses

Response samples

Content type
application/json
[]

emailForwarding_deleteEmailForwarding

Delete a particular email forwarding

Authorizations:
BearerAuth
path Parameters
id
required
string (pageId)
Example: 67ee01ffd87a29376aeb52b1

Unique ID of the page

emailBox
required
string

Email box name

Responses