Herkese açık API’ler

İstek	Sonuç
GET /api/v1	Sürüm, ortam, desteklenen zincirler ve yetenekler
GET /api/v1/collections?limit=20&offset=0&chain=84532	Herkese açık koleksiyon yapılandırması ve entegrasyon bağlantıları
GET /api/v1/collections/84532/{contract_address}	Önbellekteki zincir sayıları dahil, kayıtlı tek bir koleksiyon
GET /api/v1/collections/solana:devnet/{address}	Kayıtlı bir Solana koleksiyonu
GET /api/v1/contracts/kurvdrop	Fiyat teklifleri ve mintleme dahil, herkese açık KurvDrop ABI’si
POST /api/v1/collections/84532/{contract_address}/mint-call	Güncel bir teklif ve bir alıcı için tam çağrılar: Sayfanızdan mintleyin

const origin = 'https://testnet.kurv.fun';
const { collections } = await fetch(`${origin}/api/v1/collections?limit=20`)
  .then(response => response.json());
const collection = collections[0];
const { collection: current } = await fetch(
  `${origin}/api/v1/collections/${collection.chain_id}/${collection.contract_address}`
).then(response => response.json());

Her koleksiyonun links alanında, onu mint eden KURV penceresi olan links.mint_window ile mint planının adresi olan links.mint_call de bulunur. Başka yerden getirilen bir koleksiyonda ikisi de null olur. mint-call tek POST çağrısıdır: zinciri okur, KURV üzerinde hiçbir şeyi değiştirmez ve hiçbir şey imzalamaz.

Herkese açık tüm API yolları Access-Control-Allow-Origin: * gönderir ve yalnızca okumaları kabul eder. Çerez gerektirmezler. Listeler 1 ile 50 arasında bir sınır ve 0 ile 200 arasında bir başlangıç konumu kabul eder; sonda pagination.next_offset değeri null olur. Sürüm 1, sınırsız bir geçmiş dizini değil, görünür katalog kayıtlarının en yeni 200 tanesinden oluşan bir pencere sunar. Ayrıntı yolu, doğrudan adresleriyle ulaşılan kayıtlı koleksiyonları da destekler.

Tutarlar ve arz sayıları, tam sayı hassasiyetini koruyan ondalık metinlerdir (string). Tutarlar, koleksiyonun ödeme token’ının en küçük birimini kullanır. Biçimlendirmeden önce o token’ın decimals() ve symbol() değerlerini okuyun; her koleksiyonun altı ondalıklı USDC ile ödendiğini asla varsaymayın. max_supply, zincir durumu kullanılabilir olana kadar başlatma yapılandırmasından gelir. total_minted, uydurulmuş bir sıfır yerine bir okuma olana kadar null olur.

Ayrıntı okumaları KURV’un paylaşılan 15 saniyelik zincir önbelleğini yeniden kullanır. reading.read_at bir okumanın ne zaman başarılı olduğunu kaydeder; reading.status: "stale_or_unavailable" son girişimin başarısız olduğu ve tüm sayıların son başarılı okumaya ait olduğu anlamına gelir. Bu yanıttaki fiyat teklifi bilgi amaçlıdır, varsayılan etkin aşamadaki tek bir parça içindir ve cüzdanın mintleyebileceğini kanıtlamaz. İmzalamadan hemen önce yeni bir quoteMint alın.

Açığa çıkmamış token medyası ve metadata kökleri saklı tutulur. Ayrıca yayınlanmış bir tanıtım görseli görünür kalabilir. Gizli izin listeleri, yayın dosya listeleri, tohumlar, hesap kimlik bilgileri ve ham altyapı hataları sürüm 1’de asla yer almaz. Hatalar 400, 404 ya da 503 durum kodlarıyla { "api_version": "1", "error": { "code": "...", "message": "..." } } biçimini kullanır.

Base Sepolia için zincir kimliği 84532 olan https://testnet.kurv.fun adresini kullanın. Geliştiriciler için KURV kullanılabilir giriş noktalarını listeler. Fiyatlar ve ücretler koleksiyona bağlıdır: Ücretler ve Riskler ve sorumluluk reddi sayfalarını okuyun.