البداية السريعة

# مضيف النظام مضافًا إليه /api. كل مسار أدناه نسبةً إليه.
NEXT_PUBLIC_API_BASE_URL=https://crm.example.com/api

# أيّ موقع يمثّله هذا النشر. يُرسَل في X-Site.
NEXT_PUBLIC_SITE_KEY=my-site

# المفتاح القابل للنشر (pk_…). عامّ بالتصميم: يُدمج في حزمة المتصفّح ولا يعمل
# إلا من نطاقات هذا الموقع نفسه.
NEXT_PUBLIC_SITE_PUBLISHABLE_KEY=pk_my-site_0123456789abcdef01234567

# المفتاح السرّي (sk_…) للنداءات من الخادم. بلا بادئة NEXT_PUBLIC_ عمدًا، حتى لا
# تضعه Next في حزمة المتصفّح أبدًا. اختياري — نداءات الخادم ترجع إلى المفتاح
# القابل للنشر عند غيابه.
SITE_SECRET_KEY=

export function siteHeaders({ server = false } = {}) {
  const headers: Record<string, string> = { Accept: 'application/json' };

  const siteKey = process.env.NEXT_PUBLIC_SITE_KEY;
  if (siteKey) headers['X-Site'] = siteKey;

  // نداء الخادم لا يحمل Origin كي تفحصه الواجهة، وهذا بالضبط ما يحلّ محلّه
  // المفتاح السرّي.
  const apiKey =
    (server ? process.env.SITE_SECRET_KEY : undefined) ??
    process.env.NEXT_PUBLIC_SITE_PUBLISHABLE_KEY;
  if (apiKey) headers['X-Api-Key'] = apiKey;

  return headers;
}

export const API = process.env.NEXT_PUBLIC_API_BASE_URL!;

import { API, siteHeaders } from '@/lib/wzgate';

export default async function Page() {
  const res = await fetch(`${API}/public/company-profile`, {
    headers: siteHeaders({ server: true }),
    // الملف نادر التغيّر؛ أعد التحقّق بدل الجلب مع كل طلب.
    next: { revalidate: 300 },
  });
  if (!res.ok) throw new Error(`Company profile: ${res.status}`);

  const { data } = await res.json();
  return <h1>{data.name}</h1>;
}

import { API, siteHeaders } from '@/lib/wzgate';

export async function searchProperties(q: string, page = 1) {
  const params = new URLSearchParams({ q, page: String(page), perPage: '24' });

  const res = await fetch(`${API}/public/search?${params}`, {
    headers: siteHeaders(),
  });

  const body = await res.json();
  if (!res.ok) throw new Error(body.code ?? 'SEARCH_FAILED');

  return { rows: body.data, pagination: body.pagination };
}

{ "success": true, "data": { }, "timestamp": "2026-09-14T09:30:27.019Z" }

{
  "success": true,
  "data": [],
  "pagination": {
    "total": 100, "lastPage": 9, "currentPage": 1, "perPage": 12,
    "prev": null, "next": 2
  },
  "timestamp": "2026-09-14T09:30:27.019Z"
}

GET /public/properties?page=2&perPage=24

GET /public/properties?type=apartment
→ 400 { "message": ["property type should not exist"] }