Uygulamayı aç
Moonborn — Developers

Pazaryeri yayını

Bir persona'yı Moonborn pazaryerinde listele — moderasyon kapısı, atıflı fork soy ağacı (lineage), puanlama, isteğe bağlı ticaret (Stripe Connect, Enterprise).

Senin için işleyen bir persona paylaşılmaya değer. İki başarısızlık biçimi vardır:

  • Kapısız yayın → pazaryeri düşük kaliteli, marka-dışı veya güvensiz yayınlarla dolar
  • Soy ağacı (lineage) olmadan yayın → fork'lar kanonik çalışmayla bağını kaybeder; atıf (attribution) yok, denetim izi yok, iyileştirmeleri yukarı doğru takip yok

Moonborn pazaryeri küratörlü, fork-bilinçli bir yayın yüzeyidir: her yayın moderasyondan geçer, her fork soy ağacına bağlanır, isteğe bağlı ticaret katmanı Stripe Connect üzerindedir (Enterprise).

Bu kullanım senaryosu sana uyar mı?

  • Bir persona'yı toplulukla paylaşmak istiyorsun (ücretsiz yayın)
  • Pazaryerinden fork'lanan persona'ların kanonik çalışmana atfedilmesini istiyorsun
  • (Enterprise) Persona'ları ücretli yayın olarak satmayı planlıyorsun
  • Küratör rolü — çalışma alanı içinde persona kütüphanesi yönetiyorsun

Yapabileceklerin

  • Yayınla — bir persona'yı yayın olarak gönder, lisans + isteğe bağlı fiyat
  • Gözat — filtre (ücretsiz / ücretli / yeni / öne çıkan) + sırala (popüler / yeni / ilgi)
  • Kur (install) — yayını çalışma alanına kur (kopyalar, indirme sayar)
  • Fork — yayını lineage kenarıyla fork'la, atıf üstverisi otomatik
  • Puanla — 1-5 yıldız + isteğe bağlı inceleme (kullanıcı başına bir puan, üst-üste-yaz / upsert)
  • Bildir — kötüye kullanımı moderasyon kuyruğuna
  • Koleksiyonlar — çalışma alanı kapsamlı yayın grupları (Pro ve üzeri)

Yayınlama akışı

const listing = await client.marketplace.listings.publish({
  personaId: persona.id,
  license: 'CC-BY-4.0',
  priceCents: 0,
  description: 'Brand voice for indie devtool startups...',
  tags: ['brand-voice', 'startup', 'tech'],
});
 
console.log(listing.status); // "in_review"

Her yeni yayın in_review'a düşer. Moderasyon kapısı (marketplace.moderation.auto_approve yapılandırması) karar verir:

  • published — herkese açık
  • unpublished — reddedildi (sebep yükte)
  • in_review (devam) — elle inceleme için işaretli

Varsayılan elle inceleme; SLA marketplace.moderation.review_sla_hours (varsayılan 24 saat).

Fork ile atıf (attribution)

Bir yayın fork'landığında Moonborn:

  1. Persona'yı fork'layan çalışma alanına kopyalar
  2. Yeni persona'nın parent_persona_id = kaynak
  3. Soy ağacına kenar yazar
  4. marketplace.fork.attribution_required açıksa (varsayılan) yeni persona'ya meta.attribution = { sourceCreator, sourcePersonaId } ekler
  5. Kaynak yayının forks sayacı artar
  6. Denetim kaydına marketplace.listing.forked olayı (değiştirilemez)

Bu desen Marka sesi varyantları akışıyla eşleşir — herkese açık kanonik persona → aşağı akıştaki çalışma alanlarının marka-kilitli varyantları.

Ticaret (Stripe Connect, Enterprise)

Ticaret katmanı marketplace.commerce.enabled ile kapı altındadır (varsayılan kapalı), Stripe Connect Express'e bağlıdır:

  • Yaratıcı ilk-kurulumu (creator onboarding)OnboardCreatorUseCase; charge_enabled + payouts_enabled bayrakları
  • Gelir paylaşımımarketplace.commerce.revenue_share (varsayılan 0.7 — %70 yaratıcı, %30 platform)
  • Ödeme eşiğimarketplace.commerce.payout_min_usd (varsayılan $50)
  • Stripe Tax — KDV, GST, ABD satış vergisi otomatik
  • Mutabakat (reconciliation) cron'u — her saat usage_events ↔ Stripe defteri karşılaştır; iç defter ile Stripe asla kaymaz

Ticaret katmanı yalnızca Enterprise + Stripe Connect anlaşması yerinde olduğunda organizasyon başına açılır.

API uç noktaları

YöntemYolAmaç
GET/v1/marketplace/listingsKeşif (filtre, arama, sıralama)
POST/v1/marketplace/listings/publishİncelemeye gönder
POST/v1/marketplace/listings/{id}/installÇalışma alanına kur
POST/v1/marketplace/listings/{id}/forkSoy kenarıyla fork
POST/v1/marketplace/listings/{id}/reviewPuan + inceleme
POST/v1/marketplace/listings/{id}/reportKötüye kullanım bildirimi
GET/v1/marketplace/collectionsKüratörlü koleksiyonlar
GET/v1/marketplace/publishableYayına uygun persona'lar

Plan gereksinimi

YetenekFreeProTeamEnterprise
Gözat + kur + fork + puanla
Yayınla (ücretsiz yayın)
Koleksiyonlar
Ticaret (ücretli yayın)

Dürüst kapsam

İlgili

Pazaryeri yayını eğitimi

Yayın akışı + lisans seçimi uçtan uca.

Open →
Marka sesi varyantları

Pazaryeri fork'larından marka-kilitli varyant ailesine.

Open →
Lineage + fork tree

Atıf zinciri ve lineage yönetişimi.

Open →
Fork atfetme

Üretim-hazır atıf sorgu deseni.

Open →