Dolgozzunk együtt

Kinek szól?

Négyféle együttműködést kínálunk. A feltételeket partnerenként, személyesen egyeztetjük.

Csomagadat-API

Csak olvasható JSON-dokumentum minden olyan csomagunkról, ami online megvásárolható: úti cél, lefedett országok és hálózatok, adatkeret, érvényesség, végső ár, termékoldal-link. A dokumentum minden kiadásnál a webshop árlistájából készül — a lapon látható ár és a pénztárban terhelt összeg ugyanez.

Alapcím (base URL)

https://ql1gdzweui.execute-api.eu-central-1.amazonaws.com/v1

Hitelesítés

x-api-key fejléc, partnerenként saját kulccsal

Formátum

JSON (UTF-8), kérésre gzip-tömörítéssel

Korlát kulcsonként

5 kérés/mp (rövid löketben 10) és napi 1 000 kérés

Frissülés

minden ár- vagy kínálatváltozáskor; elég naponta egyszer lekérni

Hitelesítés

Minden kéréshez kell az x-api-key fejléc. A kulcsot a jelentkezés elbírálása után személyesen küldjük el; partnerenként egy kulcs, saját korláttal. A kulcsot csak szerveroldalon használja — böngészőben vagy mobilalkalmazásban futó kódba ne kerüljön. Ha kiszivárgott, írjon nekünk: visszavonjuk, és újat adunk.

Külön teszt- (sandbox) környezet nincs: az API csak olvas, így az éles végpont kockázat nélkül kipróbálható.

Végpontok

Lekérdezési paraméter nincs: egy válaszban minden csomag, minden pénznemben.

A válasz mezői

Felső szint

destinations[] — úti célok

destinations[].countries[] — lefedett országok

plans[] — csomagok

Példa

curl -H "x-api-key: $ESIMPONT_API_KEY" -H "Accept-Encoding: gzip" --compressed \
  https://ql1gdzweui.execute-api.eu-central-1.amazonaws.com/v1/plans

{
  "apiVersion": 1,
  "updatedAt": "2026-10-22T16:35:31Z",
  "dataVersion": "0a7c39d7c287ce38",
  "schema": "/v1/schema",
  "provider": {
    "name": "eSIMPont",
    "website": "https://www.esimpont.hu/",
    "contact": "partner@esimpont.hu"
  },
  "currencies": [
    "HUF",
    "EUR",
    "RON",
    "RSD"
  ],
  "pricesIncludeVat": true,
  "esimFee": {
    "amount": {
      "HUF": 490,
      "EUR": 1.36,
      "RON": 6.94,
      "RSD": 166.06
    },
    "appliesTo": "Purchases that need a new eSIM profile: the traveller's first purchase, or a destination that cannot be loaded onto the eSIM they already have. Top-ups onto an eSIMPont eSIM the traveller already has are exempt.",
    "waived": null
  },
  "planTerms": {
    "validityStarts": "first data connection at the destination",
    "activateWithinMonths": 12,
    "delivery": "QR code by e-mail right after payment",
    "hotspot": true,
    "topUps": true,
    "refund": "The 14-day withdrawal right ends when the QR code is delivered (the buyer consents at checkout). If a fault on our side cannot be fixed, the price is refunded."
  },
  "linkParameters": {
    "plan": "pre-selects a plan on the product page, e.g. ?plan=5gb-15d (already in every plan url)",
    "ref": "partner code for attribution, e.g. ?ref=CODE (ask us for one); remembered for 30 days",
    "utm_*": "utm_source / utm_medium / utm_campaign / utm_content are recorded",
    "currency": "fixed by the page language: hu = HUF, en/de/es/fr/sk = EUR, ro = RON, sr = RSD (see destinations[].localizedUrls)"
  },
  "destinations": [
    {
      "id": "torokorszag",
      "name": "Turkey",
      "type": "country",
      "countries": [
        {
          "iso2": "TR",
          "name": "Turkey",
          "networks": [
            "Turk Telekom Turkey",
            "Vodafone Turkey"
          ]
        }
      ],
      "url": "https://www.esimpont.hu/esim-torokorszag.html",
      "localizedUrls": {
        "hu": "https://www.esimpont.hu/esim-torokorszag.html",
        "en": "https://www.esimpont.hu/en/esim-turkey.html",
        "de": "https://www.esimpont.hu/de/esim-tuerkei.html",
        "es": "https://www.esimpont.hu/es/esim-turquia.html",
        "fr": "https://www.esimpont.hu/fr/esim-turquie.html",
        "sk": "https://www.esimpont.hu/sk/esim-turecko.html",
        "ro": "https://www.esimpont.hu/ro/esim-turcia.html",
        "sr": "https://www.esimpont.hu/sr/esim-turska.html"
      }
    }
  ],
  "plans": [
    {
      "id": "torokorszag-s-1gb-7d",
      "destinationId": "torokorszag",
      "name": "Turkey 1 GB / 7 days",
      "countries": [
        "TR"
      ],
      "dataType": "fixed",
      "dataGb": 1,
      "dailyDataGb": null,
      "validityDays": 7,
      "throttling": null,
      "prices": {
        "HUF": 890,
        "EUR": 2.9,
        "RON": 12.9,
        "RSD": 390
      },
      "url": "https://www.esimpont.hu/esim-torokorszag.html?plan=1gb-7d"
    },
    {
      "id": "torokorszag-m-5gb-15d",
      "destinationId": "torokorszag",
      "name": "Turkey 5 GB / 15 days",
      "countries": [
        "TR"
      ],
      "dataType": "fixed",
      "dataGb": 5,
      "dailyDataGb": null,
      "validityDays": 15,
      "throttling": null,
      "prices": {
        "HUF": 1990,
        "EUR": 5.9,
        "RON": 28.9,
        "RSD": 690
      },
      "url": "https://www.esimpont.hu/esim-torokorszag.html?plan=5gb-15d"
    },
    {
      "id": "torokorszag-l-20gb-30d",
      "destinationId": "torokorszag",
      "name": "Turkey 20 GB / 30 days",
      "countries": [
        "TR"
      ],
      "dataType": "fixed",
      "dataGb": 20,
      "dailyDataGb": null,
      "validityDays": 30,
      "throttling": null,
      "prices": {
        "HUF": 5590,
        "EUR": 15.9,
        "RON": 79.9,
        "RSD": 1890
      },
      "url": "https://www.esimpont.hu/esim-torokorszag.html?plan=20gb-30d"
    }
  ]
}

A példa a mai, valós adat. A plans és a destinations teljes listája a válaszban 513, illetve 171 elem.

curl -i -H "x-api-key: $ESIMPONT_API_KEY" \
  -H 'If-None-Match: "0a7c39d7c287ce38"' \
  https://ql1gdzweui.execute-api.eu-central-1.amazonaws.com/v1/plans
# HTTP/2 304  (nothing changed since this dataVersion)

Az árak jelentése

• Végső fogyasztói ár, ÁFÁ-val (pricesIncludeVat: true) — pontosan az, amit a termékoldal mutat, és amit a pénztár terhel.
• Egyszeri eSIM-díj (esimFee): 490 Ft jár a csomag mellé, ha a vásárláshoz új eSIM-profil kell — jellemzően az első vásárláskor. A meglévő eSIMPont-eSIM-re töltött csomag díjmentes.
• A pénznemet a lap nyelve adja: magyar lap = HUF, angol/német/spanyol/francia/szlovák = EUR, román = RON, szerb = RSD (localizedUrls).

Linkek és elszámolás

• Minden csomag url-je a termékoldalra visz, a csomag előválasztásával (?plan=5gb-15d).
• ?ref=KÓD — partnerkód: a vásárlás 30 napig Önhöz kötődik. A kódot és a hozzá tartozó feltételeket egyeztetés után adjuk.
• utm_source, utm_medium, utm_campaign, utm_content — ezeket rögzítjük, így a forgalmat közösen is vissza tudjuk keresni.

Példa: https://www.esimpont.hu/esim-torokorszag.html?plan=5gb-15d&ref=CODE&utm_source=yoursite&utm_medium=referral

Korlátok, hibakódok, gyorsítótár

Gyorsítótár és ETag

A válasz Cache-Control: private, max-age=3600, ETag és Last-Modified fejlécet kap. Küldje vissza a legutóbbi ETag-et az If-None-Match fejlécben: ha semmi nem változott, 304 Not Modified jön, test nélkül. Az Accept-Encoding: gzip fejléccel a válasz tömörítve érkezik.

Rendelkezésre állási garanciát (SLA-t) és státuszoldalt nem kínálunk; az API az AWS API Gateway és Lambda szolgáltatásán fut. Hiba esetén írjon a partner@esimpont.hu címre.

Verziózás és kivezetés

• A v1 szerkezete stabil. Új, nem kötelező mező bármikor megjelenhet — az ismeretlen mezőket hagyja figyelmen kívül.
• Törő változás (mező törlése, átnevezése, jelentésének megváltozása) csak új útvonalon jelenik meg (/v2).
• Egy verzió kivezetése előtt legalább 90 nappal e-mailben értesítjük az érvényes kulccsal rendelkező partnereket; addig a régi verzió változatlanul fut.

Változásnapló

Letöltések

Felhasználási feltételek

A kulcs használatával a partner elfogadja az alábbiakat. Megszegésük esetén a kulcsot visszavonhatjuk.

1. Az árat a válasz szerinti végső, ÁFÁ-s összegként és pénznemben tünteti fel, és mellette az egyszeri eSIM-díjat is (490 Ft, első vásárláskor) — a vevő a pénztárban ne találkozzon váratlan tétellel.
2. Az adatot naprakészen tartja: legalább naponta frissít, és 24 óránál régebbi árat nem mutat sajátként.
3. Az adatot a saját oldalán / szolgáltatásában jeleníti meg; harmadik félnek tovább nem adja, nem értékesíti, és más szolgáltatók árazásához nem használja fel.
4. A vásárlásra a válaszban kapott termékoldal-linkkel (url) küldi a látogatót, saját utm- vagy ref-paraméterrel. A pénztár az eSIMPont oldalán van; fizetést, kártyaadatot a partner nem kezel.
5. Az eSIMPont nevét és ajánlatát nem tünteti fel félrevezetően (pl. nem ígér olyan árat, csomagot vagy lefedettséget, ami nem szerepel a válaszban).
6. A kulcsot bizalmasan kezeli, csak szerveroldalon használja, és a korlátokat (5 kérés/mp, napi 1 000) betartja.

Jelentkezés partnernek

Írja meg, kik Önök és mire használnák az API-t vagy az együttműködést — személyesen válaszolunk. Affiliate vagy tartalomgyártó? Az Önnek szóló űrlap a partnerprogram oldalán van.