harbor-client 0.1.0

Add API key auth and billing to your Python API in one line. Harbor handles validation so your users can authenticate with keys they manage from the Harbor dashboard.

harbor-sdk for Python

Add API key auth and billing to your Python API in one line.

Install

pip install harbor-sdk

Quick Start

Flask

from flask import Flask, jsonify, g
from harbor_sdk import harbor

app = Flask(__name__)

@app.route("/data")
@harbor(project_id="proj_harbor_xyz")
def data():
    plan = g.harbor.plan  # 'free' | 'pro' | 'scale'
    return jsonify({"data": "protected", "plan": plan})

FastAPI

from fastapi import FastAPI, Request
from harbor_sdk import HarborMiddleware

app = FastAPI()
app.add_middleware(HarborMiddleware, project_id="proj_harbor_xyz")

@app.get("/data")
async def data(request: Request):
    plan = request.state.harbor.plan
    return {"data": "protected", "plan": plan}

Manual validation

from harbor_sdk import validate

info = validate(request.headers.get("X-Harbor-Key"))
if not info:
    return {"error": "Invalid API key"}, 401
print(info.plan)         # 'pro'
print(info.key_id)       # 'key_abc123'
print(info.project_id)   # 'proj_harbor_xyz'

Your users pass their key in the header

curl -H "X-Harbor-Key: hbr_live_..." https://your-api.com/data

Get your Project ID

1. Sign up at harbor-black.vercel.app
2. Create a project in your dashboard
3. Copy your Project ID

Full docs: harbor-black.vercel.app/docs