مستندات API هاب

X-Api-Key: ifound_live_your_key_here

# یا به‌صورت Bearer:
Authorization: Bearer ifound_live_your_key_here

<!-- iFound Hub — drop-in tracker. Replace YOUR_API_KEY, then place before </body> -->
<script>
(function () {
  "use strict";
  var API_KEY = "YOUR_API_KEY";
  var ENDPOINT = "http://hub.idads.ir/api/v1/ingest";
  var DOMAIN = location.hostname;

  function uid(p) {
    return p + Math.random().toString(36).slice(2, 10) + Date.now().toString(36);
  }
  function store(k, v) { try { localStorage.setItem(k, v); } catch (e) {} return v; }
  function read(k) { try { return localStorage.getItem(k); } catch (e) { return null; } }

  var VID = read("ifound_vid") || uid("v");
  store("ifound_vid", VID);
  var SID = uid("s");
  store("ifound_sid", SID);

  function send(type, data, visitor) {
    try {
      var payload = {
        type: type,
        site: { domain: DOMAIN, name: document.title, platform: "custom" },
        visitor: {
          id: VID,
          session_id: SID,
          path: location.pathname + location.search,
          title: document.title,
          referrer: document.referrer || "",
          user_agent: navigator.userAgent,
          language: navigator.language || ""
        },
        data: data || {},
        occurred_at: new Date().toISOString()
      };
      if (visitor) { for (var k in visitor) { payload.visitor[k] = visitor[k]; } }

      fetch(ENDPOINT, {
        method: "POST",
        headers: { "Content-Type": "application/json", "X-Api-Key": API_KEY },
        body: JSON.stringify(payload),
        keepalive: true,
        mode: "cors"
      }).catch(function () {});
    } catch (e) {}
  }

  if (!API_KEY || API_KEY === "YOUR_API_KEY") {
    /* Remove this guard once the key is set; it prevents junk from reaching the hub. */
    return;
  }

  /* 1. Page views (including SPA route changes) */
  var lastPath = "";
  function pageview() {
    var p = location.pathname + location.search;
    if (p === lastPath) return;
    lastPath = p;
    send("pageview");
  }
  pageview();

  ["pushState", "replaceState"].forEach(function (m) {
    var orig = history[m];
    history[m] = function () {
      var r = orig.apply(this, arguments);
      try { setTimeout(pageview, 0); } catch (e) {}
      return r;
    };
  });
  window.addEventListener("popstate", function () { setTimeout(pageview, 0); });

  /* 2. Forms — contact + order */
  document.addEventListener("submit", function (ev) {
    try {
      var form = ev.target;
      if (!form || form.tagName !== "FORM") return;
      if (form.hasAttribute("data-ifound-ignore")) return;

      var fields = {};
      var fd = new FormData(form);
      fd.forEach(function (v, k) {
        if (v instanceof File) { fields[k] = v.name; }
        else if (fields[k] === undefined) { fields[k] = String(v).slice(0, 500); }
        else { fields[k] = fields[k] + ", " + String(v).slice(0, 500); }
      });

      var isOrder = form.hasAttribute("data-ifound-order") ||
                    /order|checkout|cart|سفارش|خرید/i.test(form.id + " " + (form.className || "") + " " +
                    (form.getAttribute("name") || "") + " " + (form.getAttribute("action") || ""));

      send(isOrder ? "order" : "form", {
        form_name: form.getAttribute("data-ifound-name") ||
                   form.getAttribute("name") || form.id ||
                   (isOrder ? "فرم سفارش" : "فرم تماس"),
        fields: fields,
        page_path: location.pathname
      });
    } catch (e) {}
  }, true);

  /* 3. Call buttons */
  document.addEventListener("click", function (ev) {
    try {
      var el = ev.target && ev.target.closest ? ev.target.closest('a[href^="tel:"]') : null;
      if (el) {
        send("call", {
          button_label: (el.textContent || "").trim().slice(0, 120) || "تماس",
          phone: (el.getAttribute("href") || "").replace(/^tel:/i, ""),
          page_path: location.pathname
        });
        return;
      }
      var custom = ev.target && ev.target.closest ? ev.target.closest("[data-ifound-event]") : null;
      if (custom) {
        send("event", {
          event_name: custom.getAttribute("data-ifound-event"),
          label: custom.getAttribute("data-ifound-label") || "",
          page_path: location.pathname
        });
      }
    } catch (e) {}
  }, true);

  /* 4. Reliability: flush on the way out + a heartbeat */
  function beacon(payload) {
    try {
      var body = JSON.stringify(payload);
      if (!navigator.sendBeacon) return;
      /* sendBeacon cannot set headers AND cannot perform a CORS preflight, so:
         - the key travels as ?api_key= (the endpoint accepts it), and
         - the Blob must use text/plain, which is CORS-safelisted. A
           application/json Blob would require a preflight that a beacon cannot
           send, and the request would be dropped by the browser.
         The server still parses the body as JSON. */
      var blob = new Blob([body], { type: "text/plain;charset=UTF-8" });
      navigator.sendBeacon(ENDPOINT + "?api_key=" + encodeURIComponent(API_KEY), blob);
    } catch (e) {}
  }
  document.addEventListener("visibilitychange", function () {
    if (document.visibilityState === "hidden") {
      beacon({ type: "ping", site: { domain: DOMAIN },
               visitor: { id: VID, session_id: SID, path: location.pathname,
                          title: document.title, referrer: document.referrer || "",
                          user_agent: navigator.userAgent, language: navigator.language || "" } });
    }
  });
  document.addEventListener("click", function (ev) {
    try {
      var el = ev.target;
      if (!el || !el.closest) return;
      var tel = el.closest('a[href^="tel:"]');
      if (tel) {
        beacon({ type: "call", site: { domain: DOMAIN }, visitor: { id: VID, session_id: SID },
                 data: { button_label: (tel.textContent || "").trim().slice(0, 120) || "تماس",
                         phone: (tel.getAttribute("href") || "").replace(/^tel:/i, "") } });
      }
    } catch (e) {}
  }, true);
})();
</script>

{
  "ok": true,
  "data": {
    "received": true,
    "count": 1,
    "event_id": 128,
    "event_type": "pageview",
    "website": { "id": 3, "domain": "my-shop.ir" },
    "server_time": "۱۴۰۳/۰۳/۱۲ ۱۰:۲۲",
    "timestamp": 1718000000
  }
}