# Overview

> What an app on the Positive marketplace can do, and where to start.

Source: https://developers-staging.foodpilot.tech/get-started/overview

An app for the Positive marketplace is a web service you run. A customer platform installs it, chooses which organizations it may see and which data it may read, and the platform then talks to your app in three ways. This site documents all three, and nothing else: only what an app may rely on.

## What an app uses

| What | What it is | Read |
|---|---|---|
| **The App API** | The only HTTP API an installed app can call, under `/api/app/v1`. Read-only in version 1. | [App API](/build/app-api) and the [API reference](/reference) |
| **Webhooks** | The platform calls your HTTPS endpoint when something happens: scores computed, a questionnaire answered, the app uninstalled, a payment changed. | [Webhooks](/build/webhooks) |
| **Embedding** | Your pages open inside the platform, as a full page, a product tab or an overview card, and learn who is there from a signed session token. | [App Bridge](/build/app-bridge) and [Extension slots](/build/extension-slots) |

## The path of an app

1. **Describe it** in a [manifest](/build/manifest): its URLs, the [scopes](/build/scopes) it asks for, the webhooks and the pages it wants.
2. **Let customers install it.** The [OAuth flow](/build/authentication) gives your server an installation token, a refresh token and the secret that signs webhooks.
3. **Read the customer's data** with the [App API](/build/app-api), within the granted scopes and organizations.
4. **Listen** with [webhooks](/build/webhooks) and **show** your pages with [App Bridge](/build/app-bridge).
5. **Charge for it**, if you want to, with [billing](/build/billing).

## Good to know

- **One host per platform.** Every customer platform has its own API host. The examples use `https://{tenant}-api.example.com`: use the host your installation was made on.
- **An app token only reaches the App API.** The installation token is refused everywhere else, whatever the scopes. The data an app may see is exactly what this site documents.
- **Version 1 only gets additive changes.** A new field or a new operation can appear at any time: ignore what you do not know. Anything else is a version 2 on a new path, with [12 months of overlap](/build/app-api/versioning).
- **The reference is the contract.** The [API reference](/reference) is generated from the committed OpenAPI document, which you can [download](/openapi-3.0.json) to generate a client.
