Glossary
Platform. One customer's Positive, with its own API host (https://{tenant}-api.example.com) and its own data. Your app is installed on each platform separately.
Organization. A company, site or brand inside a platform. Organizations form a tree; an installation is granted some of them, and their descendants.
Product, ingredient, packaging. The items a platform measures. Each has scores.
Score. A computed environmental result of an item, such as its carbon footprint, with its unit.
Questionnaire. The set of questions an organization answers about an item; the answers feed the scores.
Publisher. The company that builds an app, registered in the partner space.
App. What you publish: a handle, a client id and secret, a listing, and versions.
Version. A numbered manifest, submitted for review. A released version is what platforms install.
Manifest. The JSON document that describes a version: URLs, scopes, webhooks, pages and extensions. The manifest.
Installation. Your app on one platform, with the scopes and organizations its administrator granted. It has its own tokens and webhook secret.
Scope. A permission your app asks for, such as read_products. Scopes.
Access token, refresh token. What your server calls the App API with (one hour), and what it gets a new one with (rotated at each use). Authentication.
Session token. A 60-second signed token that tells an embedded page which user, organization and installation it is shown for.
App Bridge. The library your embedded pages use to talk to the platform around them. App Bridge.
Extension slot. A place in the platform's pages where your app can show a small frame: a product tab, an organization overview card. Extension slots.
Webhook, topic. A signed HTTPS call from the platform to your app when something happens; the topic names what happened. Webhooks.
Visibility. Where an approved app is offered: private (named platforms), unlisted (from a link) or public (in the catalogue). Test your app.