Skip to content

PERS-api docs (2.0.7)

Download OpenAPI description
Overview
Languages
Servers
Mock server
https://docs.pers.ninja/_mock/swagger/
https://explorins-loyalty.ngrok.io/
https://api.pers.ninja/v2/

Tenants

Operations

Admins

Operations

Tokens

Operations

Campaigns

Operations

Campaign Tags

Operations

Campaign Tokens

Operations

Campaign Triggers

Operations

Campaign Engagements

Operations

Campaign Claims

Operations

Redemptions

Operations

Purchases

Operations

Businesses

Operations

Transactions

Operations

Users

Operations

Balances

Operations

Files

Operations

File Management System

File upload and management system for platform assets including campaign images, user avatars, and document attachments with secure storage and access control.
File Operations:

•
Secure Upload:
File upload with type validation and security scanning

•
Asset Management:
Organize and manage platform media assets

•
Access Control:
Role-based file access and sharing permissions

•
CDN Integration:
Fast global file delivery through content delivery networks

•
File Processing:
Automatic image resizing and format optimization

Generate signed URL for entity storage

Request

Creates S3 signed URLs for uploading or downloading entity files. Supports both business and admin authentication flows.

Bodyapplication/jsonrequired
entityTypestringrequired

The entity type

Enum"token""campaign""redemption""business""tenant""user"
entityIdstringrequired

The entity id

signedUrlTypestringrequired

The signed url type, GET or PUT. PUT is used for uploading files, GET is used for downloading files

Enum"GET""PUT"
fileExtensionstringrequired

The file extension

fileNamestring

The file name

curl -i -X POST \
  https://docs.pers.ninja/_mock/swagger/files/entity-storage-url \
  -H 'Content-Type: application/json' \
  -d '{
    "entityType": "token",
    "entityId": "string",
    "signedUrlType": "GET",
    "fileExtension": "string",
    "fileName": "string"
  }'

Responses

Signed URL generated successfully

Bodyapplication/json
signedUrlstringrequired

The signed url

Response
application/json
{ "signedUrl": "string" }

Web3 Chains

Operations

Contracts

Operations

Auth

Operations

Root

Operations

Well-known

Operations

webhooks

Business Types

Operations

Redemption Types

Operations

Redemption Redeems

Operations

Redemption Tokens

Operations

API Keys

Operations