Solutions

The LongLink SDK helps you build a Solution as a standard FastAPI project. The source stays yours, including its data models, rules, workflows, integrations, and API routes. LongLink does not replace the tools you already use. At runtime, the Solution runs as a FastAPI service that you can structure in the way that fits your team.

The SDK connects that service to LongLink when needed. It provides database and storage access, identifies the signed-in user, packages the source for deployment, and exposes XML interfaces to the LongLink control plane. These interfaces are called Views. The Platform displays each view consistently while the service owns the information and actions behind it.

Create a Project

bash
uvx --from longlink longlink init --folder my-solution
cd my-solution

Run these commands from a directory where you want to create the project. The scaffold includes a pyproject.toml with LongLink as a dependency.

├── src/
│   ├── models/       # SQLModel database tables
│   ├── views/        # View files
│   ├── routes/       # API routes
│   ├── schemas/      # Pydantic schemas
│   └── envs.py       # Environments
├── tests/            # Project tests
├── .env.sample       # Environment template
└── main.py           # Service entry point

For a small working project, see the LongLink sample repository(opens in new tab).

Local Development

bash
uv sync --group dev
uv run longlink migrate
uv run longlink dev

Navigate to http://127.0.0.1:1707(opens in new tab) to preview the service locally.