واجهات API العامة

الطلب	النتيجة
GET /api/v1	الإصدار، والبيئة، والسلاسل المدعومة، والإمكانات
GET /api/v1/collections?limit=20&offset=0&chain=84532	إعدادات المجموعات العامة وروابط التكامل
GET /api/v1/collections/84532/{contract_address}	مجموعة مسجّلة واحدة، بما فيها أرقام السلسلة المخزّنة مؤقتًا
GET /api/v1/collections/solana:devnet/{address}	مجموعة Solana مسجلة واحدة
GET /api/v1/contracts/kurvdrop	KurvDrop ABI العام، بما فيه عروض الأسعار والسكّ
POST /api/v1/collections/84532/{contract_address}/mint-call	سعر حديث والاستدعاءات الدقيقة لمشترٍ واحد: السكّ من صفحتك

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());

تتضمن links في كل مجموعة أيضًا links.mint_window، وهي نافذة KURV التي تسكّها، وlinks.mint_call، وهو عنوان خطة السكّ. وتكون القيمتان null في مجموعة جُلبت من مكان آخر. وmint-call هو POST الوحيد: يقرأ السلسلة ولا يغيّر شيئًا في KURV ولا يوقّع شيئًا.

ترسل كل مسارات API العامة Access-Control-Allow-Origin: * ولا تقبل إلا القراءة. ولا تحتاج إلى ملفات تعريف الارتباط. وتقبل القوائم حدًا من 1 إلى 50 وإزاحة من 0 إلى 200؛ وتكون قيمة pagination.next_offset هي null في النهاية. ويتيح الإصدار 1 نافذة من أحدث 200 سجل ظاهر في الفهرس، لا فهرسًا تاريخيًا غير محدود. ويدعم مسار التفاصيل أيضًا المجموعات المسجّلة التي يُوصل إليها بعنوانها المباشر.

المبالغ وأعداد المعروض نصوص عشرية، تحافظ على دقة الأعداد الصحيحة. وتستخدم المبالغ أصغر وحدة لرمز الدفع الخاص بالمجموعة. ويُستحسن قراءة decimals() وsymbol() لذلك الرمز قبل التنسيق؛ وعدم الافتراض أبدًا أن كل مجموعة تُسوّى بعملة USDC ذات الخانات العشرية الست. وتأتي max_supply من إعداد الإطلاق إلى أن تتوفر حالة السلسلة. وتكون total_minted هي null إلى أن توجد قراءة، بدلًا من صفر مختلق.

تعيد قراءات التفاصيل استخدام ذاكرة KURV المؤقتة المشتركة للسلسلة، ومدتها 15 ثانية. ويسجّل reading.read_at وقت نجاح القراءة؛ وتعني reading.status: "stale_or_unavailable" أن آخر محاولة فشلت وأن أي أرقام تعود إلى آخر قراءة ناجحة. وعرض السعر في هذه الاستجابة للعلم فقط، وهو لقطعة واحدة في المرحلة النشطة الافتراضية، ولا يثبت أن المحفظة تستطيع السكّ. ويجب الحصول على quoteMint حديث مباشرةً قبل التوقيع.

تُحجب وسائط الرموز غير المكشوفة وجذور بياناتها. ويمكن أن تبقى صورة تشويقية منشورة بشكل منفصل ظاهرة. ولا يتضمن الإصدار 1 أبدًا قوائم السماح الخاصة، أو قوائم ملفات النشر، أو البذور، أو بيانات اعتماد الحسابات، أو أخطاء البنية التحتية الخام. وتستخدم الأخطاء الصيغة { "api_version": "1", "error": { "code": "...", "message": "..." } } مع رموز الحالة 400 أو 404 أو 503.

يُستخدم https://testnet.kurv.fun لـ Base Sepolia، بمعرّف السلسلة 84532. وتسرد صفحة KURV للمطوّرين نقاط الدخول المتاحة. وتتوقف الأسعار والرسوم على المجموعة: التفاصيل في الرسوم والمخاطر وإخلاء المسؤولية.