API

نقطتا اتصال عامتان تشغّلان أداة التوافق. الاستخدام مجاني مع الإشارة إلى المصدر. لا حاجة لحساب أو مفتاح API.

الإشارة إلى المصدر

مجاني مع وضع رابط ظاهر إلى esimcompatibility.com. نعتمد على الروابط الواردة لإبقاء البيانات مفتوحة.

المصادقة

بدون. وصول عام ومجهول. الردود مُخبّأة بفعالية على حافة الشبكة.

`GET /api/check`

بحث في الأجهزة

ابحث عن الأجهزة بنص حر. يعيد حتى 25 نتيجة، مرتّبة حسب الصلة وسنة الإصدار.

المعامل	النوع	إلزامي	الوصف
q	string	yes	Free-text query. Example: "iPhone 16 Pro"
limit	integer 1–25	no	Max results to return. Default 10.

curl

curl 'https://esimcompatibility.com/api/check?q=iphone+16+pro&limit=5'

JavaScript

const res = await fetch(
  `https://esimcompatibility.com/api/check?q=${encodeURIComponent("iPhone 16 Pro")}`
);
const { results, count } = await res.json();

الاستجابة

{
  "results": [
    {
      "slug": "apple/iphone-16-pro",
      "brand": "Apple",
      "brandSlug": "apple",
      "model": "iPhone 16 Pro",
      "modelSlug": "iphone-16-pro",
      "releaseYear": 2024,
      "category": "phone",
      "supports": "yes",
      "exceptionRegions": ["china-mainland"]
    }
  ],
  "count": 1
}

`GET /api/detect`

كشف تلقائي للجهاز

تعريف جهاز الزائر عبر User-Agent وتلميحات العميل Sec-CH-UA-Model / Sec-CH-UA-Platform. يعيد قيمة null إذا لم يمكن تحديد جهاز بعينه.

المعامل	النوع	إلزامي	الوصف
User-Agent	header	no	Standard browser UA. Used as fallback when client hints are not sent.
Sec-CH-UA-Model	header	no	Client Hint. The device model (e.g. "Pixel 8 Pro").
Sec-CH-UA-Platform	header	no	Client Hint. The OS platform (e.g. "Android").

curl

curl -H 'Sec-CH-UA-Model: "iPhone 16 Pro"' \
     -H 'Sec-CH-UA-Platform: "iOS"' \
     https://esimcompatibility.com/api/detect

JavaScript

const res = await fetch("https://esimcompatibility.com/api/detect");
const { match, brand, model } = await res.json();
// match is null when no specific device can be identified.

الاستجابة

{
  "match": {
    "slug": "apple/iphone-16-pro",
    "brand": "Apple",
    "brandSlug": "apple",
    "model": "iPhone 16 Pro",
    "modelSlug": "iphone-16-pro",
    "releaseYear": 2024,
    "category": "phone",
    "supports": "yes",
    "exceptionRegions": ["china-mainland"]
  },
  "brand": "Apple",
  "model": "iPhone 16 Pro"
}