DevRoute SDK

<!-- Step 2: Add the SDK -->
<script src="https://www.devroute.app/sdk/v3/devroute.min.js"></script>

<!-- Step 3: Initialize -->
<script>
  DevRoute.init({
    apiKey: 'esim_live_YOUR_API_KEY',
    onResult: function(result) {
      console.log('Device:', result.device.brand, result.device.model);
      console.log('eSIM supported:', result.esim?.supported);
    }
  });
</script>

<script src="https://www.devroute.app/sdk/v3/devroute.min.js"></script>

<script src="https://www.devroute.app/sdk/v3.0.0/devroute.min.js"></script>

DevRoute.init({
  // Required
  apiKey: 'esim_live_YOUR_API_KEY',

  // Called with the result object when detection succeeds
  onResult: function(result) {
    // result contains device, eSIM, network, and risk data
  },

  // Called if the API request fails (optional)
  onError: function(err) {
    console.warn('DevRoute error:', err.message);
  }
});

{
  // ── Device — Free+ ──────────────────────────────────────────────────
  device: {
    id:               "sha256_device_hash",  // unique device fingerprint
    brand:            "Samsung",
    model:            "Galaxy S24",
    type:             "Galaxy S24 Ultra 5G",
    confidence:       0.92,
    detectionMethod:  "server-index-lookup",
    os: {
      name:    "Android",
      version: "14"
    },
    screenResolution: "1080x2340",
    pixelRatio:       3,
    timezone:         "America/New_York",
    language:         "en-US",
    family:           "Galaxy S24 Series",
    hash:             "sha256..."
  },

  // ── eSIM — Starter+ ─────────────────────────────────────────────────
  esim: {
    supported:         true,
    dualEsim:          false,
    conversionStrategy: "guided_install",
    recommendedFlow:    "step_by_step",
    osReady:           true,
    minOs:             "9.0",
    transferSupported:  false
  },

  // ── Network — Growth+ ───────────────────────────────────────────────
  network: {
    type:         "4g",
    ip:           "203.0.113.42",
    isp:          "Comcast Cable",
    vpn:          false,
    webrtcLeak:   false,
    asn:          7922,
    httpProtocol: "HTTP/2",
    tlsVersion:   "TLSv1.3",
    velocity: {
      flagged: false,
      count:   0
    }
  },

  // ── Hardware — Growth+ ──────────────────────────────────────────────
  hardware: {
    gpu:     "Adreno 750",
    ram:     8,
    cores:   8
  },

  // ── Security — Enterprise+ ──────────────────────────────────────────
  security: {
    privateMode:          null,
    emulator:             false,
    bot:                  false,
    botSubtype:           null,
    webrtcRealIp:         null,
    riskScore:            8,
    threatScore:          0,
    conflicts:            [],
    identityInconsistent: false,
    consistency: {
      score:   1.0,
      reasons: []
    }
  },

  // ── Geolocation — Enterprise+ ───────────────────────────────────────
  geolocation: {
    country:            "US",
    city:               "New York",
    region:             "New York",
    continent:          "NA",
    postalCode:         "10001",
    isEUCountry:        false,
    latitude:           40.71,
    longitude:          -74.00,
    timezoneMismatch:   false
  },

  // ── Intelligence — Starter+ ─────────────────────────────────────────
  intelligence: {
    decisions: { // 5 layers — depth varies by plan },
    profile:     { // user segment — Growth+ },
    scores:      { // risk/conversion/experience — Growth+ },
    narrative:   { // headlines and recommendations }
  },

  // ── Rules — Starter+ ────────────────────────────────────────────────
  rules: [
    {
      name:      "US Premium Flow",
      label:     "us_premium",
      type:      "country",
      value:     "US",
      action:    "allow",
      priority:  10,
      tags:      ["geo"],
      matchedOn: ["country"]
    }
  ],

  // ── Access — Enterprise+ ────────────────────────────────────────────
  access: {
    outcome:    "allow",
    source:     "system",
    reason:     "low_fraud_risk",
    confidence: 0.85
  }
}

DevRoute.init({
  apiKey: 'esim_live_YOUR_KEY',
  mode: 'light',           // ← minimal response
  onResult: function(result) {
    // result is a grouped object, no flat fields
    console.log(result.device?.brand);    // "Samsung"
    console.log(result.esim?.supported);  // true
    console.log(result.network?.type);    // "4g"
    console.log(result.rules);             // matched rules array
    console.log(result.access?.outcome);  // "allow" | "block" | "flag"
  }
});

DevRoute.init({
  apiKey: 'esim_live_YOUR_KEY',
  onResult: function(result) {
    // handle device intelligence
  },
  onRule: function(rules) {
    // rules = [{ label, action, type, value }, ...]
    rules.forEach(function(rule) {
      if (rule.action === 'block') {
        showBlockedMessage(rule.label);
      } else if (rule.action === 'flag') {
        logSuspicious(rule.label, rule.type);
      } else if (rule.action === 'allow') {
        enablePremiumFlow(rule.value);
      }
    });
  }
});

// Get the last matched rule (null if none)
var rule = DevRoute.getRule();
// → { label: "us_premium", action: "allow", type: "country", value: "US" }

// Get the full cached result object
var cached = DevRoute.getLastResult();
// → full result object (with rules array, etc.)

// SDK version
console.log(DevRoute.version); // "3.0.0"

var d = result.intelligence.decisions;

        // Always use .value to drive your logic
        console.log(d.esim_flow.value);   // "auto_install"
        console.log(d.esim_flow.reason);  // "iOS 17 with confirmed eSIM — use Quick Transfer"

        console.log(d.friction.value);    // "none" | "soft" | "hard"
        console.log(d.security_gate.value); // "none" | "review" | "block"
        console.log(d.ui_mode.value);     // "streamlined" | "standard" | "cautious"
        console.log(d.priority.value);    // "high" | "medium" | "low"

var intel = result.intelligence;

// User segment
intel.profile.segment;     // "genuine_user" | "corporate_user" | "privacy_user"
                            // | "traveler" | "developer" | "fraudulent_actor"
                            // | "automated_actor" | "tor_user" | "unclassified"
intel.profile.confidence;  // 0.0–1.0 segment confidence
intel.profile.signals;    // ["esim_capable", "residential_isp", ...]

// Authenticity
intel.authenticity.score;   // 0–100 (higher = more authentic)
intel.authenticity.verdict; // "authentic" | "suspicious" | "likely_bot"

// Scores (0–100)
intel.scores.risk;        // fraud risk (lower = safer)
intel.scores.conversion;  // likelihood to convert (higher = better)
intel.scores.experience;  // UX quality score — use to gate premium features

DevRoute.init({
  apiKey: 'esim_live_YOUR_KEY',
  onResult: function(result) {
    // happy path
  },
  onError: function(err) {
    // err.message — human-readable error
    // Common: "HTTP 401" (bad key), "HTTP 429" (limit reached), network errors
    console.warn('[DevRoute]', err.message);
  }
});

DevRoute.init({
  apiKey: 'esim_live_YOUR_KEY',
  onResult: function(result) {
    var flow = result.esim.conversionStrategy;

    if (flow === 'direct_install') {
      // iOS 16+ / Pixel — tap-through carrier activation, no QR needed
      showActivateButton(carrierDeepLinkUrl);

    } else if (flow === 'guided_install') {
      // Samsung / Android 12+ — OS-native Settings wizard
      showGuidedModal(result.brand, result.OS.version);

    } else if (flow === 'qr_install') {
      // eSIM supported, show QR code for profile download
      showQRCode();

    } else if (flow === 'manual_install') {
      // Low-confidence detection — show activation code entry
      showActivationCodeForm();

    } else if (flow === 'unsupported_device') {
      // Device can't use eSIM — offer physical SIM or upgrade
      showPhysicalSimFallback();
    }

    // Optional: use intelligence decisions for UX fine-tuning
    var d = result.intelligence?.decisions;
    if (d?.ui_mode?.value === 'streamlined') collapseSecondaryOptions();
    if (d?.priority?.value === 'high') showPremiumPlanBanner();
  }
});

DevRoute.init({
  apiKey: 'esim_live_YOUR_KEY',
  onResult: function(result) {
    var gate     = result.intelligence?.decisions?.security_gate?.value;
    var friction = result.intelligence?.decisions?.friction?.value;

    if (gate === 'block') {
      blockSession();          // high-confidence fraud
    } else if (gate === 'review' || friction === 'hard') {
      showSmsVerification();   // suspicious — step-up auth
    } else if (friction === 'soft') {
      showCaptcha();           // mild friction only
    } else {
      enableCheckout();        // clean session
    }
  }
});

DevRoute.init({
  apiKey: 'esim_live_YOUR_KEY',
  onResult: function(result) {
    var riskScore  = result.risk_score;   // 0–100
    var isBot      = result.bot;
    var isVpn      = result.vpn;           // Growth+
    var conflicts  = result.signal_conflicts; // array of contradiction strings

    if (isBot || riskScore > 80) {
      blockSession();
    } else if (isVpn || riskScore > 50 || conflicts.length > 1) {
      triggerStepUpVerification();
    } else {
      enableCheckout();
    }
  }
});

var REGIONAL_PRICES = {
  'US': { amount: '$4.99',  currency: 'USD' },
  'GB': { amount: '£3.99',  currency: 'GBP' },
  'DE': { amount: '€4.49',  currency: 'EUR' },
  'IN': { amount: '₹99',    currency: 'INR' },
};

DevRoute.init({
  apiKey: 'esim_live_YOUR_KEY',
  onResult: function(result) {
    var country = result.geolocation?.country;
    var price   = REGIONAL_PRICES[country] || REGIONAL_PRICES['US'];
    document.getElementById('price-display').textContent = price.amount;
  }
});