@waylay/client
TypeScript icon, indicating that this package has built-in type declarations

2.57.1 • Public • Published

Waylay Client

A javascript SDK client that interfaces with the Waylay REST API's.

Installation

Installation in modern web applications

yarn add @waylay/client

or

npm install --save @waylay/client

With a script tag

You can also include the generated umd file directly into a script tag. This will add a global waylay function to the window. You can access this via window.waylay or just waylay

Include script tag

<!doctype html>

<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
</head>

<body>
  <!-- Place script tag at the end of body -->
  <!-- to get the latest version: -->
  <script src="https://unpkg.com/@waylay/client/dist/waylay.umd.js"></script>

  <!-- to get a specific version: -->
  <script src="https://unpkg.com/@waylay/client@2.44.0/dist/waylay.umd.js"></script>
</body>
</html>

Usage

When installed with npm

Create a client, using an apiKey and secret

const Waylay = require('@waylay/client')
const gateway = 'https://api.waylay.io'
const waylay = new Waylay({gateway})
await waylay.authenticate(myApiKey, myApiSecret)

Create a client, with a Waylay jwt token that was acquired elsewhere:

const waylay = new Waylay({gateway, token})

When included with a script tag

Create a new client, using user login (requires the tenant to be identified by its domain).

// notice the lowercase waylay
const client = new waylay({gateway, domain: 'myDomain.waylay.io'})

// login example
async function login(user, password){
  try {
    await client.login(user, password)
  } catch(err) {
    // error happened while logging in
  }
  await client.loadSettings()
}

Documentation

The API documentation for the SDK itself can be found at sdk.waylay.io. It documents how to authenticate and configure the client, and describes the services, resources and operations that are available.

The SDK client wraps the Waylay REST APIs as documented at docs.waylay.io. That documentation describes the request and response messages that you'll encounter when interacting with the SDK.

Readme

Keywords

Package Sidebar

Install

npm i @waylay/client

Weekly Downloads

63

Version

2.57.1

License

ISC

Unpacked Size

3.35 MB

Total Files

137

Last publish

Collaborators

  • claudiu.muresan.pfa
  • thomas_waylay
  • bo-sec
  • waylaydevops
  • waylay_io