Getting started
Quickstart
Create a test secret key, check a licence key from your server, and switch to live when you're ready.
Before you start
- Early access to the maker console, with your organisation set up.
- A product of yours listed on Ploba, and a licence key from a test subscription to it.
- The Owner or Admin role in your organisation (only they can create keys).
Steps
Create a test secret key
In the console, open Settings → API keys and create a key with thetestenvironment. Copy it straight away: it’s shown once.Store it on your server
Keep it in an environment variable such asPLOBA_SECRET_KEY. Never ship it in a browser, an app bundle or a public repository.Verify a licence key
Send the user’s licence key toPOST /verify-license:
curl -X POST https://api.ploba.app/api/v1/external/developer/verify-license \
-H "Authorization: Bearer $PLOBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{ "licenseKey": "<the user's licence key>" }'Read the response
200 means the licence is active;datasays which product and plan it belongs to. 404 means there’s no active licence with that key for your organisation: refuse the request.Go live
Create alivekey and swap it in. Nothing else changes. Then report usage if you charge per call.