Admin

PERS-api docs (1.7.2)

Download OpenAPI description
swagger.json
swagger.yaml
Overview
Languages
Servers
Mock server
https://docs.pers.ninja/_mock/swagger/
https://api.pers.ninja/v1.7/

Introduction

Introducing PERS (Phygital Experience Rewards System) the ultimate SaaS of Loyalty & Reward System. Connect PERS API to your system and get ready to create multi-projects, with your own dashboard and independent database, while ensuring users data confidentiality. This structure enables:

  • Interoperable Rewards
  • Boost Customer Engagement
  • Simplified Management
  • Effortless Integration
  • Security and Privacy
  • Data-Driven Strategy PERS System

Setup Flow

This diagram illustrates the comprehensive flow of creating and connecting various components within the SaaS PERS ecosystem. It outlines the interactions and dependencies between Tokens, Campaigns, Redemptions, Purchase, and Business entities. API Flow

Claim Campaign

The Claim System Flow in SaaS PERS outlines the process through which rewards and tokens can be claimed by different entities within the system. This flow ensures that the claiming process is secure, efficient, and flexible, catering to various use cases and integration requirements. Claim System Flow This flow ensures that the process of claiming rewards is adaptable to various scenarios, making it seamless for system administrators, business partners, and end-users to interact with the reward system efficiently.

Tenant

Operations

Token

Operations

Campaign

Operations

Redemption

Operations

Purchase

Operations

Business

Operations

Transaction

Operations

User

User endpoints

Operations

Admin

Operations

ADMIN: Get all admins

Request

Get all admins

curl -i -X GET \
  https://docs.pers.ninja/_mock/swagger/admin/admin \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Admins found

Bodyapplication/jsonArray [
idstringrequired

Id of the admin

emailstringrequired

Email of the admin

displayNameobjectrequired

Display name of the admin

typestringrequired

Type of the admin

Enum"SUPER_ADMIN""TENANT_ADMIN"
tenantsobject

Tenant of the admin

]
Response
application/json
[
  {
    "id": "string",
    "email": "string",
    "displayName": {},
    "type": "SUPER_ADMIN",
    "tenants": {}
  }
]

ADMIN: Create or update admin

Request

Create or update admin

Bodyapplication/jsonrequired
emailstringrequired

Email of the admin

displayNamestring

Display name of the admin

typestringrequired

Type of the admin

Enum"SUPER_ADMIN""TENANT_ADMIN"
curl -i -X POST \
  https://docs.pers.ninja/_mock/swagger/admin/admin \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "string",
    "displayName": "string",
    "type": "SUPER_ADMIN"
  }'

Responses

Admin created or updated

Bodyapplication/json
idstringrequired

Id of the admin

emailstringrequired

Email of the admin

displayNameobjectrequired

Display name of the admin

typestringrequired

Type of the admin

Enum"SUPER_ADMIN""TENANT_ADMIN"
tenantsobject

Tenant of the admin

Response
application/json
{
  "id": "string",
  "email": "string",
  "displayName": {},
  "type": "SUPER_ADMIN",
  "tenants": {}
}

ADMIN: Add or remove admin to tenant

Request

Add or remove admin to tenant, this relates automatically to the tenant of current admin invoking method

Path
adminIdstringrequired
Bodyapplication/jsonrequired
emailstringrequired

Email of the admin

displayNamestring

Display name of the admin

typestringrequired

Type of the admin

Enum"SUPER_ADMIN""TENANT_ADMIN"
curl -i -X PUT \
  'https://docs.pers.ninja/_mock/swagger/admin/admin/{adminId}/toggle-tenant' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "string",
    "displayName": "string",
    "type": "SUPER_ADMIN"
  }'

Responses

Admin added or removed from tenant

Bodyapplication/json
idstringrequired

Id of the admin

emailstringrequired

Email of the admin

displayNameobjectrequired

Display name of the admin

typestringrequired

Type of the admin

Enum"SUPER_ADMIN""TENANT_ADMIN"
tenantsobject

Tenant of the admin

Response
application/json
{
  "id": "string",
  "email": "string",
  "displayName": {},
  "type": "SUPER_ADMIN",
  "tenants": {}
}

Auth

Operations

Web3 Contract

Operations

Web3 Chain

Operations

Root

Operations

Balance

Operations

File

Operations