0.0.275 • Published 3 months ago

@smartico/public-api v0.0.275

Weekly downloads
-
License
ISC
Repository
-
Last release
3 months ago

Smartico Public API

API allows you to build custom Gamification UI using smartico.ai as a backend system.

Please contact your Smartico account manager to get the API keys
and for terms of API usage

Front-end usage

To use the API you need the smartico.js library installed and initialized on your site according to this guide https://help.smartico.ai/welcome/technical-guides/front-end-integration

As soon as the _smartico object is available in the global context of the browser window and the user is identified, you can call API methods to get the data or act on behalf of the logged-in user.

_smartico.api.getLevels().then( levels => {
    console.log('There are ' + levels.length + ' levels available');
});

Some methods can be called with onUpdate callback, which is executed when there are changes in the underlying data. Example:

var miniGamesUpdates = (games) => {
    console.log('There are ' + games.length + ' games available now');
}

_smartico.api.getMiniGames( { onUpdate: miniGamesUpdates} ).then( games => {
    console.log('There are ' + games.length + ' games available');
});

See the API documentation for all available methods and returning data.

Visitor mode

You can also get gamification data for the visitors (not authorized users).

Calls to the methods look similar, with the only exception that you need to use _smartico.vapi('EN') method to get access to the Visitor API object with a specific language.

Note: please contact your Success Manager on the Smartico side to enable Visitor mode

_smartico.vapi('EN').getLevels().then( levels => {
    console.log('There are ' + levels.length + ' levels available');
});

Backend usage (NodeJS context)

Note: access to the server-to-server API is not provided by default and is a topic for a separate agreement with Smartico. We recommend using a front-end API approach in most cases.

Installation

npm install --save @smartico/public-api

Usage

import { SmarticoAPI } from '@smartico/public-api';

const SAPI = new SmarticoAPI( 'your-label-api-key', 'your-brand-key', 'your-message-sender', { logger: console });

const userExtId = 'John1984'
            
const response = await SAPI.miniGamesGetTemplates(userExtId);

response.templates.forEach( t => {
    console.log(t.saw_template_ui_definition.name)
}

Development and publishing process

Publishing process

git commit
npm run build
npm version patch
npm run pub

To debug locally

In the public-api project:

npm link
# when you are done
npm unlink

In the target project

npm link @smartico/public-api --legacy-peer-deps

# when you are done
npm unlink @smartico/public-api --legacy-peer-deps && npm install @smartico/public-api --legacy-peer-deps
0.0.205

8 months ago

0.0.204

8 months ago

0.0.203

8 months ago

0.0.202

9 months ago

0.0.209

8 months ago

0.0.208

8 months ago

0.0.207

8 months ago

0.0.206

8 months ago

0.0.201

9 months ago

0.0.200

9 months ago

0.0.216

7 months ago

0.0.215

7 months ago

0.0.214

7 months ago

0.0.213

7 months ago

0.0.219

7 months ago

0.0.218

7 months ago

0.0.217

7 months ago

0.0.212

7 months ago

0.0.211

8 months ago

0.0.210

8 months ago

0.0.227

6 months ago

0.0.226

6 months ago

0.0.225

6 months ago

0.0.224

6 months ago

0.0.229

6 months ago

0.0.228

6 months ago

0.0.223

6 months ago

0.0.222

6 months ago

0.0.221

6 months ago

0.0.220

6 months ago

0.0.197

9 months ago

0.0.196

9 months ago

0.0.195

9 months ago

0.0.194

9 months ago

0.0.199

9 months ago

0.0.198

9 months ago

0.0.193

9 months ago

0.0.192

9 months ago

0.0.191

9 months ago

0.0.190

9 months ago

0.0.274

3 months ago

0.0.273

3 months ago

0.0.272

3 months ago

0.0.271

3 months ago

0.0.275

3 months ago

0.0.270

3 months ago

0.0.186

10 months ago

0.0.185

10 months ago

0.0.189

9 months ago

0.0.188

9 months ago

0.0.187

10 months ago

0.0.238

6 months ago

0.0.237

6 months ago

0.0.236

6 months ago

0.0.235

6 months ago

0.0.239

6 months ago

0.0.230

6 months ago

0.0.234

6 months ago

0.0.233

6 months ago

0.0.232

6 months ago

0.0.231

6 months ago

0.0.249

5 months ago

0.0.248

5 months ago

0.0.247

5 months ago

0.0.246

5 months ago

0.0.241

6 months ago

0.0.240

6 months ago

0.0.245

5 months ago

0.0.244

5 months ago

0.0.243

5 months ago

0.0.242

5 months ago

0.0.259

4 months ago

0.0.258

4 months ago

0.0.257

4 months ago

0.0.252

5 months ago

0.0.251

5 months ago

0.0.250

5 months ago

0.0.256

4 months ago

0.0.255

4 months ago

0.0.254

4 months ago

0.0.253

4 months ago

0.0.269

3 months ago

0.0.268

3 months ago

0.0.263

4 months ago

0.0.262

4 months ago

0.0.261

4 months ago

0.0.260

4 months ago

0.0.267

4 months ago

0.0.266

4 months ago

0.0.265

4 months ago

0.0.264

4 months ago

0.0.184

10 months ago

0.0.183

10 months ago

0.0.182

10 months ago

0.0.181

10 months ago

0.0.180

11 months ago

0.0.179

11 months ago

0.0.178

11 months ago

0.0.175

11 months ago

0.0.174

11 months ago

0.0.173

11 months ago

0.0.172

11 months ago

0.0.177

11 months ago

0.0.176

11 months ago

0.0.171

11 months ago

0.0.170

12 months ago

0.0.159

1 year ago

0.0.158

1 year ago

0.0.153

1 year ago

0.0.152

1 year ago

0.0.151

1 year ago

0.0.150

1 year ago

0.0.157

1 year ago

0.0.156

1 year ago

0.0.155

1 year ago

0.0.154

1 year ago

0.0.169

12 months ago

0.0.164

1 year ago

0.0.163

1 year ago

0.0.162

1 year ago

0.0.161

1 year ago

0.0.168

12 months ago

0.0.167

12 months ago

0.0.166

12 months ago

0.0.165

1 year ago

0.0.160

1 year ago

0.0.128

1 year ago

0.0.127

1 year ago

0.0.126

1 year ago

0.0.125

1 year ago

0.0.129

1 year ago

0.0.124

1 year ago

0.0.123

1 year ago

0.0.122

1 year ago

0.0.139

1 year ago

0.0.138

1 year ago

0.0.137

1 year ago

0.0.136

1 year ago

0.0.131

1 year ago

0.0.130

1 year ago

0.0.135

1 year ago

0.0.134

1 year ago

0.0.133

1 year ago

0.0.132

1 year ago

0.0.149

1 year ago

0.0.148

1 year ago

0.0.147

1 year ago

0.0.142

1 year ago

0.0.141

1 year ago

0.0.140

1 year ago

0.0.146

1 year ago

0.0.145

1 year ago

0.0.144

1 year ago

0.0.143

1 year ago

0.0.120

1 year ago

0.0.121

1 year ago

0.0.119

1 year ago

0.0.118

1 year ago

0.0.117

1 year ago

0.0.116

1 year ago

0.0.115

1 year ago

0.0.114

1 year ago

0.0.113

1 year ago

0.0.112

1 year ago

0.0.111

1 year ago

0.0.110

1 year ago

0.0.109

1 year ago

0.0.108

1 year ago

0.0.107

2 years ago

0.0.106

2 years ago

0.0.105

2 years ago

0.0.104

2 years ago

0.0.103

2 years ago

0.0.102

2 years ago

0.0.101

2 years ago

0.0.100

2 years ago

0.0.99

2 years ago

0.0.98

2 years ago

0.0.97

2 years ago

0.0.96

2 years ago

0.0.91

2 years ago

0.0.92

2 years ago

0.0.93

2 years ago

0.0.94

2 years ago

0.0.84

2 years ago

0.0.85

2 years ago

0.0.86

2 years ago

0.0.87

2 years ago

0.0.88

2 years ago

0.0.89

2 years ago

0.0.45

2 years ago

0.0.46

2 years ago

0.0.47

2 years ago

0.0.80

2 years ago

0.0.82

2 years ago

0.0.83

2 years ago

0.0.73

2 years ago

0.0.74

2 years ago

0.0.75

2 years ago

0.0.76

2 years ago

0.0.77

2 years ago

0.0.78

2 years ago

0.0.79

2 years ago

0.0.70

2 years ago

0.0.71

2 years ago

0.0.72

2 years ago

0.0.62

2 years ago

0.0.63

2 years ago

0.0.64

2 years ago

0.0.65

2 years ago

0.0.66

2 years ago

0.0.68

2 years ago

0.0.69

2 years ago

0.0.60

2 years ago

0.0.61

2 years ago

0.0.59

2 years ago

0.0.51

2 years ago

0.0.52

2 years ago

0.0.53

2 years ago

0.0.54

2 years ago

0.0.55

2 years ago

0.0.56

2 years ago

0.0.57

2 years ago

0.0.58

2 years ago

0.0.90

2 years ago

0.0.50

2 years ago

0.0.48

2 years ago

0.0.49

2 years ago

0.0.40

2 years ago

0.0.41

2 years ago

0.0.42

2 years ago

0.0.43

2 years ago

0.0.44

2 years ago

0.0.37

2 years ago

0.0.38

2 years ago

0.0.39

2 years ago

0.0.34

2 years ago

0.0.35

2 years ago

0.0.36

2 years ago

0.0.30

2 years ago

0.0.31

2 years ago

0.0.32

2 years ago

0.0.33

2 years ago

0.0.27

3 years ago

0.0.28

3 years ago

0.0.29

3 years ago

0.0.26

3 years ago

0.0.25

3 years ago

0.0.24

3 years ago

0.0.23

3 years ago

0.0.22

3 years ago

0.0.21

3 years ago

0.0.20

3 years ago

0.0.19

3 years ago

0.0.18

3 years ago

0.0.17

3 years ago

0.0.16

3 years ago

0.0.15

3 years ago

0.0.14

3 years ago

0.0.13

3 years ago

0.0.12

3 years ago

0.0.11

3 years ago

0.0.10

3 years ago

0.0.9

3 years ago

0.0.8

3 years ago

0.0.7

3 years ago

0.0.6

3 years ago

0.0.5

3 years ago

0.0.4

3 years ago

0.0.3

3 years ago

0.0.2

3 years ago