Register an Application

Registering an application tells General Wisdom about your product so it can be listed on the marketplace and receive session traffic.

Prerequisites

• An organization with Provider status (create one first)
• You must have the Owner, Admin, or Developer role in your organization

Step 1: Start the Application Wizard

1. Navigate to /developer/applications in the platform.
2. Click Create New Application.
3. The creation wizard walks you through each step.

Step 2: Basic Information

Fill in the core details about your application:

Field	Required	Description
Application Name	Yes	The display name shown in the marketplace
Slug	Yes	URL-safe identifier (auto-generated from name, editable)
Short Description	Yes	One-line summary (max 120 characters)
Full Description	Yes	Markdown-supported detailed description
Application URL	Yes	The base URL where your application is hosted
Callback URL	Yes	Where users are redirected after session initialization
Logo	Yes	Application icon (256x256px PNG, transparent background)
Cover Image	No	Hero image for marketplace listing (1200x630px)

Application Name: Maritime Vessel Tracker
Slug: maritime-vessel-tracker
Short Description: Real-time AIS vessel tracking with historical route analysis
Application URL: https://app.maritimetracker.io
Callback URL: https://app.maritimetracker.io/gw/session

tip

Your Callback URL is the endpoint that receives the session JWT when a user launches your app from the marketplace. The JWT is appended as a query parameter: https://your-app.com/gw/session?gwSession=<JWT>.

Step 3: Categories and Tags

Select categories that describe your application to help users find it in the marketplace:

Primary Category (required — choose one):

• People Intelligence
• Corporate Intelligence
• Geospatial
• Cyber Threat Intelligence
• Financial Intelligence
• Maritime & Aviation
• Social Media
• Dark Web
• Open Source Data

Tags (optional — up to 10): Add keyword tags for more specific discoverability (e.g., ais, vessel-tracking, shipping, ports).

Step 4: Technical Configuration

Configure how General Wisdom communicates with your application:

JWKS Endpoint

Provide your JWKS (JSON Web Key Set) endpoint so General Wisdom can validate session tokens:

JWKS URI: https://app.maritimetracker.io/.well-known/jwks.json

If you are using the SDK's built-in key management, this is handled automatically. See Auth Providers for details.

Session Webhook (Optional)

Register a webhook URL to receive real-time session lifecycle events:

Webhook URL: https://app.maritimetracker.io/webhooks/gw
Webhook Secret: whsec_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Events delivered:

• session.started — User launched a session
• session.paused — User paused the session
• session.resumed — User resumed from pause
• session.ended — Session ended (expiry or user action)
• session.extended — User purchased additional time

SDK Version Requirement

Specify the minimum SDK version your application requires:

Minimum SDK Version: 1.0.0

Step 5: Environment Configuration

General Wisdom supports multiple environments for development and testing:

Environment	Purpose	Base URL
Development	Integration testing with test tokens	https://api.dev.generalwisdom.com
Production	Live marketplace with real tokens	https://platform.generalwisdom.com

You receive separate API keys for each environment. Development sessions use test SMART tokens that have no monetary value.

Step 6: Review and Submit

Review all your configuration on the summary page. Once submitted:

1. Your application enters Draft state.
2. You can test sessions using the development environment.
3. When ready, submit for marketplace review (see Marketplace Listing).

Application States

State	Description
Draft	Initial state. Only visible to your team. Can be tested in dev.
In Review	Submitted for marketplace review. Cannot be modified.
Approved	Approved and visible on the marketplace.
Suspended	Temporarily removed from marketplace (by you or GW admin).
Rejected	Did not pass review. Feedback provided. Return to Draft to fix.

API Keys

After registration, you receive API keys for authenticating SDK requests:

# Development
GW_API_KEY=gw_dev_sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# Production (available after marketplace approval)
GW_API_KEY=gw_prod_sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

caution

Never expose your API keys in client-side code. They should only be used server-side. The SDK handles client-side authentication via JWT tokens.

Updating Your Application

After initial registration, you can update any field except the slug:

1. Navigate to /developer/applications.
2. Click on your application.
3. Edit fields as needed.
4. Click Save Changes.

Changes to live applications (Approved state) take effect immediately except for pricing changes, which require a 24-hour notice period.

---

Next Steps

1. Configure your marketplace listing (pricing, screenshots, categories)
2. Integrate the SDK into your application
3. Set up JWT validation for session authentication