Vollständige Referenz aller öffentlichen Endpoints. Erstelle und verwalte digitale Produkte programmatisch — direkt aus eigenen Skripten, Servern oder dem Monemee MCP-Server für Claude.
Für Web-Apps mit Login, Desktop-Software und Python-Tools gibt es ein offenes SDK. Die CLI loggt dich ein, legt das Produkt an, schreibt die .env und bindet die Paywall in deinen Code ein, alles erst im Testmodus.
npx monemee initPakete: monemee-node (Express, Next.js), monemee-react, monemee-client (Electron, Tauri, Erweiterungen, offline signiert) und monemee für Python.
SDK auf GitHub · Dokumentation · Anleitungen (Electron, Chrome-Erweiterung, Next.js, Python, Tauri)
Jeder Request braucht einen API-Key im Authorization-Header. Keys erstellst du unter Settings → API & Integrationen. Sie beginnen mit monemee_, werden auf unserer Seite nur als SHA-256-Hash gespeichert und können jederzeit widerrufen werden.
Authorization: Bearer monemee_xxxxxxxxxxxxxxxxxxxxxxxxWenn du einen MCP-Client wie claude.ai integrierst, kannst du statt eines statischen API-Keys den OAuth-2.1-Flow nutzen — inkl. Dynamic Client Registration nach RFC 7591. Das passiert in claude.ai automatisch beim Hinzufügen des Custom Connectors. Discovery-Doc:
GET https://monemee.com/.well-known/oauth-authorization-server/api/oauth/register, /oauth/authorize, /api/oauth/tokenmonemee:write (MCP-Werkzeuge) oder monemee:cli (zusätzlich die komplette /public-API, z. B. für npx monemee)POST /mcp/v1 ausgeführt (Streamable-HTTP-Transport)https://monemee.com/api/v1429 und der Meldung „Rate limit exceeded for this API key."POST/PATCH-Requests erwarten application/json (außer uploads/sign beim tatsächlichen Datei-PUT — dort der MIME-Type der Datei).POST /api/v1/licenses/validate, /activate, /deactivate und /resend prüfen Lizenzschlüssel deiner Käufer direkt aus der App — ohne API-Key, mit CORS für Browser. Schritt-für-Schritt-Anleitung mit Code für React, Node, Python, Chrome-Extension und CLI: Lizenzschlüssel in deine App einbauen.
/public/meIdentitäts-Probe. Prüft, dass dein Key gültig ist, und gibt den zugehörigen User zurück. Ideal zum Testen der Verbindung.
{
"success": true,
"data": {
"user_id": 123,
"email": "creator@example.com",
"api_key": { "id": 5, "name": "Claude Desktop", "prefix": "monemee_abcdef" }
}
}/public/productsListet alle Produkte des authentifizierten Users (drafts + active + archived) inklusive Module.
{
"success": true,
"data": [
{
"id": 42,
"title": "LinkedIn Hook Generator",
"frontend_type": "ki_prompts",
"price": "14.90",
"status": "active",
"modules": [...],
...
}
]
}/public/productsLegt ein neues Produkt an. Pflichtfeld: frontend_type. Erlaubte Werte: ebook, template, course, link, newsletter, coaching, software, ki_prompts.
Bei frontend_type: "ki_prompts" rendert Monemee ausprompt_content automatisch eine .md-Datei und liefert sie als File-Modul aus.
{
"frontend_type": "ki_prompts",
"title": "LinkedIn Hook Generator",
"description": "10 Hooks für eine eingegebene Zielgruppe.",
"price": 14.90,
"prompt_content": "Du bist ein erfahrener LinkedIn-Stratege...",
"affiliate_commission": 20,
"status": "draft"
}Lade die Datei zuerst über POST /public/uploads/sign + PUT + POST /public/uploads/finalize hoch und übergib das resultierende file_url als Modul.
{
"frontend_type": "template",
"title": "Notion Productivity Bundle",
"description": "<p>5 verknüpfte Notion-Datenbanken.</p>",
"price": 19.90,
"status": "draft",
"modules": [
{
"type": "file",
"title": "notion-bundle.zip",
"sort_order": 0,
"file_url": "https://storage.googleapis.com/.../notion-bundle.zip",
"file_name": "notion-bundle.zip",
"file_size": 248320
}
]
}Bei frontend_type: "software" verbindet Monemee dein privates GitHub-Repo. Beim Veröffentlichen (status: "active") wird der Branch als ZIP oder das Release-Asset heruntergeladen und als File-Modul gespeichert. Der PAT wird AES-256-verschlüsselt.
{
"frontend_type": "software",
"title": "DATEV-MCP-Server",
"description": "MCP-Server für DATEV-Buchhaltung.",
"price": 199,
"status": "draft",
"github_repo_url": "https://github.com/dein-name/datev-mcp",
"github_pat": "github_pat_xxx",
"github_branch": "main",
"github_delivery_mode": "zip"
}/public/products/:idEinzelnes Produkt mit allen Modulen. Muss dem Key-Inhaber gehören.
/public/products/:idPartielles Update. Nur die mitgesendeten Felder ändern sich. PUT wird als Alias akzeptiert (für SDKs, die kein PATCH sprechen). Bei status: "active" auf einem KI-Prompt-Produkt mit geändertem prompt_content wird die .md neu generiert. Bei software-Produkten zieht der Server das GitHub-Artifact neu.
{
"price": 24.90,
"status": "active"
}/public/uploads/signErster Schritt des zwei-Schritt-Uploads. Gibt eine signierte Firebase-Storage-URL zurück, an die du die Datei direkt perPUT sendest. Die signierte URL ist 15 Minuten gültig. Erlaubte Inhaltstypen: PDF, ZIP, EPUB, MP4, WebM, MP3, JPG/PNG/WebP/GIF. HTML, JS und SVG sind aus Sicherheitsgründen blockiert.
{
"fileName": "guide.pdf",
"contentType": "application/pdf"
}{
"success": true,
"data": {
"uploadUrl": "https://storage.googleapis.com/...&X-Goog-Signature=...",
"fileUrl": "https://storage.googleapis.com/<bucket>/products/api/123/1730500000_guide.pdf",
"objectPath": "products/api/123/1730500000_guide.pdf",
"fileName": "guide.pdf",
"contentType": "application/pdf",
"expiresAt": "2026-05-02T12:15:00.000Z"
}
}/public/uploads/finalizeZweiter Schritt: nachdem du per PUT hochgeladen hast, ruft finalize auf, um das Objekt öffentlich lesbar zu machen. Erst danach ist file_url aus der Sign-Response tatsächlich abrufbar. Idempotent. Funktioniert nur für Objekte unter products/api/<deine-user-id>/.
{
"objectPath": "products/api/123/1730500000_guide.pdf"
}Produkte mit aktivierten Lizenzschlüsseln stellen bei jedem Kauf einen Schlüssel im Format MM-XXXX-XXXX-XXXX-XXXX aus. Deine App prüft ihn über diese Endpoints: kein API-Key, offener CORS, eigene Rate-Limits statt des allgemeinen API-Limits: 60 Anfragen/Minute pro IP und 30 Anfragen/Minute pro Schlüssel (bei Überschreitung 429 mit code: "LICENSE_RATE_LIMIT_EXCEEDED"). Die Antwort ist bei gültigem Request immer 200 mit valid: true|false; 400 nur bei fehlendem/ungültigem key oder product_id. Basis-URL: https://monemee.com/api/v1/licenses. Fertige Snippets (JavaScript, Python, curl, KI-Prompt) findest du im Dashboard unter Produkt → Lizenzschlüssel → Integration.
/licenses/validateNebenwirkungsfreie Prüfung. device_id ist optional: Ist sie gesetzt und das Gerät nicht aktiviert, kommt valid: true mit device.activated: false (deine App entscheidet, ob sie activate ruft). Ist das Gerätelimit erreicht und das Gerät fehlt, kommt valid: false, reason: "device_not_activated".
{
"key": "MM-A7K2-9FQ3-XT8M-2B4C",
"product_id": 123,
"device_id": "optional-fingerprint"
}{
"success": true,
"data": {
"valid": true,
"license_id": 987,
"product_id": 123,
"plan": "pro",
"status": "active",
"expires_at": "2027-10-30T12:00:00.000Z",
"activations": { "used": 1, "max": 3 },
"device": { "activated": true, "device_id": "optional-fingerprint" }
}
}Bei ungültigem Schlüssel: reason ist eines von not_found, revoked, expired, product_mismatch, device_not_activated.
{
"success": true,
"data": { "valid": false, "reason": "revoked", "product_id": 123 }
}/licenses/activateBindet ein Gerät an den Schlüssel. device_id ist Pflicht (max. 128 Zeichen aus A-Z a-z 0-9 . _ : -), device_name optional. Idempotent: erneutes activate mit derselben device_id aktualisiert nur last_seen_at. Bei erreichtem Limit: valid: false, reason: "activation_limit".
{
"key": "MM-A7K2-9FQ3-XT8M-2B4C",
"product_id": 123,
"device_id": "fp-abc",
"device_name": "MacBook von Lisa"
}{
"success": true,
"data": {
"valid": false,
"reason": "activation_limit",
"activations": { "used": 3, "max": 3 }
}
}/licenses/deactivateGibt ein Gerät wieder frei (z.B. Schaltfläche „Gerät freigeben" in deiner App).
{
"key": "MM-A7K2-9FQ3-XT8M-2B4C",
"product_id": 123,
"device_id": "fp-abc"
}{
"success": true,
"data": { "deactivated": true, "activations": { "used": 2, "max": 3 } }
}/licenses/resendSchickt dem Käufer seinen Schlüssel erneut per E-Mail. Antwortet immer gleich (keine Rückschlüsse, ob ein Kauf existiert). Anti-Spam: 1 Anfrage pro 10 Minuten je E-Mail/Produkt und 5 pro Stunde je IP, darüber 429 mit code: "LICENSE_RESEND_RATE_LIMIT_EXCEEDED".
{ "email": "kaeufer@example.com", "product_id": 123 }{
"success": true,
"message": "Falls ein Kauf vorliegt, wurde der Schlüssel per E-Mail gesendet."
}Mit API-Key (wie alle /public-Endpoints). Lizenzen gehören dem Verkäufer des Produkts; fremde Objekte liefern 404. Über die Public API und MCP wird nie ein Klartext-Schlüssel ausgegeben (auch nicht bei reissue; der Käufer bekommt ihn per E-Mail), buyer_email ist in Listen maskiert.
/public/products/:idLizenzschlüssel pro Produkt aktivieren. license_max_activations (1–1000, null = unbegrenzt), license_duration_days (1–3650, null = unbegrenzt), license_plan_name (max. 50 Zeichen, optional).
{
"license_enabled": true,
"license_max_activations": 3,
"license_duration_days": null,
"license_plan_name": "pro"
}/public/products/:id/licensesListe der Schlüssel eines Produkts. Query: status (active|revoked|expired), test (1 = nur Test-Schlüssel, 0 = nur echte), q (Käufer-E-Mail oder Prefix), limit (1–200, Standard 50), offset. Jedes Element trägt is_test.
{
"success": true,
"data": {
"items": [
{
"id": 987,
"product_id": 123,
"transaction_id": 456,
"key_prefix": "MM-A7K2",
"plan": "pro",
"status": "active",
"effective_status": "active",
"expires_at": null,
"revoked_at": null,
"revoke_reason": null,
"replaced_by_id": null,
"activations": { "used": 1, "max": 3 },
"buyer_email": "ka***@example.com",
"last_validated_at": "2026-11-01T09:12:00.000Z",
"validation_count": 42,
"created_at": "2026-10-30T12:00:00.000Z"
}
],
"total": 1,
"limit": 50,
"offset": 0
}
}/public/products/:id/licenses/testErzeugt einen Test-Schlüssel, um die Lizenzprüfung in der eigenen App auszuprobieren, ohne zu kaufen: 30 Tage gültig, Plan und Gerätelimit wie echte Schlüssel, kein Verkauf, keine Webhooks. validate/activate antworten zusätzlich mit "test": true. Kein Body. Die Public-API-Antwort enthält nur key_prefix – der Klartext wird einmalig im Dashboard unter „Lizenzschlüssel“ angezeigt. Als MCP-Tool: create_test_license_key. Fehler: 400 LICENSE_NOT_ENABLED, 409 LICENSE_TEST_LIMIT (max. 3 aktive Test-Schlüssel pro Produkt), 429 LICENSE_TEST_KEY_RATE_LIMIT_EXCEEDED (10 pro Stunde). Test-Schlüssel lassen sich nicht neu ausstellen (409 LICENSE_TEST_KEY_NO_REISSUE).
{
"success": true,
"data": {
"license": { "id": 990, "key_prefix": "MM-T3ST", "is_test": true, "expires_at": "2026-12-04T10:00:00.000Z", "...": "..." },
"key_prefix": "MM-T3ST"
}
}/public/licenses/:licenseIdDetail wie Listen-Element, zusätzlich activations_list[].
{
"success": true,
"data": {
"id": 987,
"key_prefix": "MM-A7K2",
"effective_status": "active",
"activations": { "used": 1, "max": 3 },
"activations_list": [
{
"id": 77,
"device_id": "fp-abc",
"device_name": "MacBook von Lisa",
"activated_at": "2026-10-30T12:05:00.000Z",
"last_seen_at": "2026-11-01T09:12:00.000Z",
"deactivated_at": null
}
]
}
}/public/licenses/:licenseId/revokeSperrt den Schlüssel sofort (reason: "manual"; refund, chargeback und reissued setzt das System selbst). Idempotent. Antwort: das Lizenz-Objekt.
{ "reason": "manual" }/public/licenses/:licenseId/reissueSperrt den alten Schlüssel (reissued), stellt einen neuen mit denselben Einstellungen aus und mailt ihn dem Käufer. Die Antwort enthält nur key_prefix und email_sent, keinen Klartext (den sieht allein der Creator einmalig im Dashboard). 409 mit code: "LICENSE_REISSUE_CONFLICT", wenn der Schlüssel bereits ersetzt wurde (replaced_by_id) oder wegen Refund/Chargeback gesperrt ist.
{
"success": true,
"data": {
"license": { "id": 988, "key_prefix": "MM-Q9ZT", "effective_status": "active", "...": "..." },
"replaced_license_id": 987,
"key_prefix": "MM-Q9ZT",
"email_sent": true
}
}/public/licenses/:licenseId/activations/:activationIdGibt ein aktiviertes Gerät frei.
{ "success": true, "data": { "released": true, "activation_id": 77 } }/public/products/:id/licenses/snippetsFertige Integrations-Snippets mit eingesetzter product_id: { "javascript", "python", "curl", "prompt" } (jeweils String). Der prompt ist der Text für Lovable/Claude Code/Cursor.
Webhooks: Neben sale.completed (jetzt mit license_id und license_key_prefix) gibt es license.created, license.revoked und license.activated, alle ohne Klartext.
Für Apps mit eigenem Nutzerkonto: Der Kauf wird an die Nutzer-ID deiner App (ref) gebunden, und dein Backend fragt nur noch „hat dieser Nutzer Zugang?“. Eine eigene Datenbank-Spalte brauchst du dafür nicht. Auth mit einem App-Secret pro Produkt (mmapp_test_… / mmapp_live_…), angelegt unter „Lizenzschlüssel → App-Anbindung“ oder per POST /public/products/:id/app-secrets. Das Secret gehört nur auf deinen Server. Test-Secrets sehen nur Testkäufe, Live-Secrets nur echte. Fachliche Ablehnungen kommen als 200 mit { "access": false, "reason": … }.
https://monemee.com/buy/:productId?ref=<nutzer-id>Kauf-Link für deine App, führt direkt zur Bezahlseite. Mit ref ist der Kauf sofort dem Nutzer zugeordnet (max. 128 Zeichen aus A-Z a-z 0-9 . _ : @ -). Hast du eine Rücksprung-URL (return_url am Produkt) hinterlegt, landet der Käufer danach mit ?monemee_claim=mmc_… wieder bei dir (Token 30 Minuten gültig, einmalig).
/apps/claimRücksprung-Token (claim) oder Lizenzschlüssel (key) einlösen und an ref binden. Eine gebundene Lizenz lässt sich nicht an einen anderen Nutzer weitergeben (ref_mismatch); lösen kannst du sie mit POST /public/licenses/:id/unbind. Ein Nutzer kann mehrere Lizenzen haben (z. B. vorzeitige Verlängerung); access nimmt die am längsten gültige.
POST /api/v1/apps/claim
Authorization: Bearer mmapp_live_…
{ "claim": "mmc_…", "ref": "user_42" }
{ "success": true, "data": { "access": true, "ref": "user_42", "plan": "pro",
"expires_at": "2027-11-21T10:00:00.000Z", "license_id": 123, "test": false } }/apps/accessHat ref Zugang? reason: no_license, revoked (Erstattung, Sperre), expired. Antworten kurz zwischenspeichern; die Webhooks license.revoked und license.created tragen external_ref zum sofortigen Aktualisieren.
{ "ref": "user_42" }/apps/test-claimNur mit Test-Secret: Testkauf ohne Geld. Stellt eine Testlizenz für ref aus und liefert redirectUrl mit Rücksprung-Token, also genau den Ablauf eines echten Kaufs. Optional return_url für lokale Tests (nur localhost oder die Domain der Produkt-Rücksprung-URL).
/apps/meDiagnose: Produkt, Modus, return_url und buy_url zum Secret.
/public/products/:id/fileNeue Version einer Produktdatei (z. B. aus der GitHub Action monemee/monemee-dev/action). Ersetzt die Datei im bestehenden Modul; die Download-Links bisheriger Käufer bleiben gültig und liefern die neue Version. Body: file_url (aus /uploads/sign + /finalize), file_name, file_size, optional module_id.
/products/:id/badge.svgÖffentliches Abzeichen „Kaufen auf MoneMee · Preis“ für READMEs und Webseiten.
[](https://monemee.com/p/123)SDKs, CLI (npx monemee init) und Beispiele: Monemee Dev-Kit.
Download-Software: /licenses/validate und /activate liefern zusätzlich signed (Ed25519). Prüfe signed.signature über den exakten String signed.payload mit dem öffentlichen Schlüssel aus /.well-known/monemee-license-keys.json. So darf deine App eine Weile offline laufen.
Alle Fehler folgen demselben JSON-Schema. HTTP-Status zeigt die Kategorie: 400 = ungültiges Payload, 401 = Auth fehlt/ungültig, 403 = Zugriff verweigert (z.B. fremdes Objekt), 404 = Ressource nicht gefunden, 429 = Rate-Limit, 5xx = Server.
{
"success": false,
"message": "Invalid or revoked API key."
}# 1) Signed URL holen
curl -X POST https://monemee.com/api/v1/public/uploads/sign \
-H "Authorization: Bearer monemee_…" \
-H "Content-Type: application/json" \
-d '{"fileName":"guide.pdf","contentType":"application/pdf"}'
# Response liefert uploadUrl + objectPath + fileUrl
# 2) Datei hochladen (direkt zu Firebase Storage, KEIN Authorization-Header!)
curl -X PUT "<uploadUrl-aus-Schritt-1>" \
-H "Content-Type: application/pdf" \
--data-binary @./guide.pdf
# 3) Objekt veröffentlichen (Public-Read freischalten)
curl -X POST https://monemee.com/api/v1/public/uploads/finalize \
-H "Authorization: Bearer monemee_…" \
-H "Content-Type: application/json" \
-d '{"objectPath":"<objectPath-aus-Schritt-1>"}'
# Jetzt fileUrl in einem Produkt-Modul verwendenimport fetch from 'node-fetch';
const API_KEY = process.env.MONEMEE_API_KEY;
async function createPromptProduct(title, prompt, price) {
const res = await fetch('https://monemee.com/api/v1/public/products', {
method: 'POST',
headers: {
Authorization: `Bearer ${API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
frontend_type: 'ki_prompts',
title,
price,
prompt_content: prompt,
status: 'draft'
})
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
return res.json();
}API-Key erstellen, Endpoint aufrufen, Produkt veröffentlichen.