الانتقال إلى الوثائق
SparkGlimDeveloper
مركز التكامل بمساعدة الذكاء الاصطناعي
SparkGlimSparkGlim للمطوّرين
ابحث في جميع الوثائق

جرّب موضوعًا بلغتك أو مسار API دقيقًا.

    أدلة التكامل

    استخدم واجهة المنظمة الإصدار 1 من خادمك

    ابدأ بنطاق معتمد ومفاتيح كاملة ثم قراءة آمنة قبل العمليات الخاصة الموقعة.

    قبل البدء

    • حساب منظمة معتمد ونطاق HTTPS متحقق ومفاتيح كاملة من إعدادات المنشئ.
    • Node 20+ لحزمة مساحة العمل المحلية أو HTTPS من Python أو PHP على خادمك.
    • مرجع الإصدار 1 والقدرات اللازمة؛ إصدار الواجهة 1 مختلف عن إصدار التوقيع 2.
    01

    اضبط المفاتيح واقرأ البيانات

    احفظ SPARKGLIM_APPROVED_DOMAIN ومفاتيح keyId:secret كاملة على الخادم فقط. ترسل القراءات x-white-label-domain والمفتاح العام أو مفتاح الحملة الكامل دون اختراع معرف منفصل.

    يفترض TypeScript أن @sparkglim/organization-sdk المحلية مبنية ومتاحة في مشروعك. نشرها على npm غير متحقق. تستخدم أمثلة Python وPHP طلبات HTTPS مباشرة دون الادعاء بوجود حزم مخصصة.

    طلب توضيحي بقيم بديلة
    typescript
    import { SparkGlimOrganization } from '@sparkglim/organization-sdk';
    const client = new SparkGlimOrganization({
      baseUrl: 'https://api.sparkglim.net',
      domain: process.env.SPARKGLIM_APPROVED_DOMAIN!,
      publicKey: process.env.SPARKGLIM_PUBLIC_KEY,
      privateKey: process.env.SPARKGLIM_PRIVATE_KEY,
      campaignKey: process.env.SPARKGLIM_CAMPAIGN_KEY,
    });
    export async function readOrganizationCampaigns() {
      return client.campaigns.list();
    }
    02

    افهم التوقيع الخاص

    تتطلب العمليات HMAC الإصدار 2 والنطاق والوقت وnonce جديدًا والنطاقات وعدم التكرار. الصيغة: v2.domain.idempotencyKey.campaignKey.timestamp.nonce.METHOD.pathname.sortedQuery.sha256(rawBody). وقع البايتات المرسلة والاستعلام المرتب المرمز.

    توقع الحزمة الطرق المنفذة فيها. لا تضمّنها في المتصفح ولا تعيد nonce ولا تنسخ موقع WordPress القديم بوصفه العقد الحالي.

    03

    جهز دفع اختبار صريحًا

    تستخدم الدالة غير النشطة client.checkout.create مع الحقول الفعلية الموثقة وreturn_path نسبي مسموح. المدخل لا يحدد سعرًا يقبله الخادم كمرجع موثوق.

    احفظ مفتاح عدم التكرار للعملية نفسها وأعد authorization_url للعميل. يدير Server الدفع والتسليم دون تحقق أو استطلاع دفع من المتصفح.

    طلب توضيحي بقيم بديلة
    typescript
    import { randomUUID } from 'node:crypto';
    import { SparkGlimOrganization } from '@sparkglim/organization-sdk';
    export async function createApprovedTestCheckout(client: SparkGlimOrganization, input: unknown, stableRequestId: string, approvedTest: boolean) {
      if (!approvedTest) throw new Error('Approved test configuration required');
      const data = await client.checkout.create(input, stableRequestId);
      if (typeof data.authorization_url !== 'string') throw new Error('No paid checkout URL returned');
      const target = new URL(data.authorization_url);
      if (target.origin !== 'https://checkout.sparkglim.net' || target.username || target.password) throw new Error('Invalid checkout URL');
      return { authorization_url: target.href };
    }
    export const newRequestId = () => randomUUID();

    تحقق من تكاملك

    • تحقق من النطاق والصلاحيات وبقاء الأسرار خارج الحزم والسجلات.
    • اختبر التوقيعات المرفوضة بتصريح فقط وميز المصدر المحلي والنشر والتشغيل.