Technical Reference

S-PRO Enterprise Master (v12.3) is an API-driven subscriber lifecycle engine. It utilizes the Google Apps Script V8 runtime to bridge high-volume webhooks with high-deliverability Gmail infrastructure.

Pixel Engine

1x1 Invisible Tracking Image Integration.

Concurrency

20s Lock Wait to prevent data corruption.

Gmail Hub

HTML-ready professional composition.

Client-Side Setup

To interface with the S-PRO engine from your front-end or external services, use the following configuration structure.

const CONFIG = {
    SCRIPT_URL: 'https://yourappscriptlinl/exec',
    API_KEY: 'yourprivatekey'
};

Ensure the SCRIPT_URL matches your deployed Google Apps Script web app endpoint. The API_KEY must match the MY_SECRET_WORD defined in your script.

Security Protocol

Master Authentication

Administrative access and write operations (POST) are protected by a static secret.

// Security Definition
const MY_SECRET_WORD = "yourprivatekey";
Brute Force Mitigation Automatic lockout after 5 failed attempts for 15 minutes.
Cache Sessions Tokens are managed via CacheService with a strict 24-hour TTL.
GET

Public Trackers

Action Required Params Effect
track email Increments 'Opens' metric.
click email, redirect Increments 'Clicks' & redirects user.
subscribe email, name Registers node & sends welcome mail.

Tracking Image Implementation

Include this inside your HTML email body:

<img src="WEB_APP_URL?action=track&email=user@example.com" width="1" height="1" />
POST

Administrative Hub

POST requests require a JSON payload. Security is verified via data.key.

Method: COMPOSE

Dispatches high-fidelity emails through the Gmail Hub API.

{
  "key": "yourprivatekey",
  "method": "COMPOSE",
  "to": "target@domain.com",
  "subject": "Node Update",
  "body": "<p>Rich HTML Body</p>"
}

Method: SYNC

Manually synchronizes a subscriber node into the database.

{
  "key": "yourprivatekey",
  "email": "newnode@domain.com",
  "name": "Developer"
}

Data Integrity

Lock Protocol

S-PRO implements LockService.getScriptLock() with a 20s threshold. All write operations are queued to prevent spreadsheet race conditions during high API traffic.