Współpracuj z eSIM Park

Z kim współpracujemy

Wybierz model, który do Ciebie pasuje. Jeśli żaden nie pasuje, i tak napisz — opisz, co masz na myśli.

API pakietów w skrócie

Endpoint REST tylko do odczytu, który zwraca jeden dokument JSON: wszystkie pakiety dostępne online na esimpark.com, z tymi samymi cenami, które pokazuje strona produktu i które pobiera kasa.

Bazowy URL

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

Format

JSON (UTF-8), gzip na żądanie

Uwierzytelnianie

nagłówek x-api-key, jeden klucz na partnera

Ceny

ceny końcowe z VAT w walutach: USD, EUR, GBP, PLN, RON, HUF

Aktualizacje

dokument jest budowany przy każdym wydaniu; wystarczy pobierać raz dziennie

Specyfikacja maszynowa

OpenAPI 3.1 (YAML) · JSON Schema

Uwierzytelnianie

Każde zapytanie wymaga klucza API w nagłówku x-api-key. Klucze wydajemy partnerom po rozpatrzeniu wniosku — złóż go poniżej albo napisz na partner@esimpark.com.

• Trzymaj klucz na serwerze. API nie wysyła nagłówków CORS, więc zapytania z przeglądarki się nie powiodą — a klucz w kodzie front-endu byłby publiczny.
• Jeśli klucz wycieknie, daj znać: wyłączymy go i wydamy nowy.
• Brakujący, błędny lub wyłączony klucz dostaje 403.

Endpointy

Dwa endpointy GET. Nie ma parametrów zapytania: jedna odpowiedź zawiera wszystkie pakiety we wszystkich walutach.

Przykładowe zapytanie

curl --compressed \
  -H "x-api-key: $ESIMPARK_API_KEY" \
  -H 'If-None-Match: "<last ETag>"' \
  https://uj684erdvk.execute-api.eu-central-1.amazonaws.com/v1/plans

Przykładowa odpowiedź (skrócona: jeden kierunek i dwa jego pakiety)

{
  "apiVersion": 1,
  "updatedAt": "2026-10-27T10:50:12Z",
  "dataVersion": "92291e58d693d2be",
  "schema": "/v1/schema",
  "provider": {
    "name": "eSIM Park",
    "website": "https://www.esimpark.com/",
    "contact": "partner@esimpark.com"
  },
  "currencies": [
    "USD",
    "EUR",
    "GBP",
    "PLN",
    "RON",
    "HUF"
  ],
  "pricesIncludeVat": true,
  "esimFee": {
    "amount": {
      "USD": 1.63,
      "EUR": 1.36,
      "GBP": 1.23,
      "PLN": 6.19,
      "RON": 7.42,
      "HUF": 490
    },
    "appliesTo": "Purchases that need a new eSIM profile (normally the first purchase). Top-ups onto an eSIM Park eSIM the traveller already has are exempt.",
    "waived": {
      "from": "2026-09-16T00:00:00+02:00",
      "until": "2027-01-01T00:00:00+01:00"
    }
  },
  "planTerms": {
    "validityStarts": "first connection to a supported network at the destination",
    "delivery": "QR code by e-mail right after payment",
    "hotspot": true,
    "topUps": true,
    "refund": "full refund within 15 days if the eSIM was not installed and no data was used"
  },
  "linkParameters": {
    "cur": "ISO currency code to open the page in, e.g. ?cur=EUR",
    "ref": "partner code for attribution, e.g. ?ref=CODE (ask us for one)",
    "utm_*": "utm_source / utm_medium / utm_campaign / utm_content are recorded"
  },
  "destinations": [
    {
      "id": "torokorszag",
      "name": "Turkey",
      "type": "country",
      "countries": [
        {
          "iso2": "TR",
          "name": "Turkey",
          "networks": [
            "Turk Telekom Turkey",
            "Vodafone Turkey"
          ]
        }
      ],
      "url": "https://www.esimpark.com/esim-turkey.html",
      "localizedUrls": {
        "en": "https://www.esimpark.com/esim-turkey.html",
        "pl": "https://www.esimpark.com/pl/esim-turcja.html"
      }
    }
  ],
  "plans": [
    {
      "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": {
        "USD": 5.9,
        "EUR": 4.9,
        "GBP": 4.9,
        "PLN": 22.9,
        "RON": 27.9,
        "HUF": 1790
      },
      "url": "https://www.esimpark.com/esim-turkey.html"
    },
    {
      "id": "torokorszag-xl-3gbday-5d",
      "destinationId": "torokorszag",
      "name": "Turkey 3 GB/day / 5 days",
      "countries": [
        "TR"
      ],
      "dataType": "daily",
      "dataGb": null,
      "dailyDataGb": 3,
      "validityDays": 5,
      "throttling": {
        "afterPercentOfDailyData": 80,
        "speedKbps": 128,
        "dailyDataCarriesOver": false
      },
      "prices": {
        "USD": 13.9,
        "EUR": 11.9,
        "GBP": 9.9,
        "PLN": 50.9,
        "RON": 60.9,
        "HUF": 3990
      },
      "url": "https://www.esimpark.com/esim-turkey.html"
    }
  ]
}

Wartości pochodzą z aktualnego dokumentu z chwili budowania tej strony.

Pola odpowiedzi

Nowe pola opcjonalne mogą pojawić się w każdej chwili — ignoruj te, których nie znasz. Kwoty są w jednostkach głównych (22.9 = 22,90); HUF nie ma części ułamkowej.

Poziom główny

destinations[]

plans[]

Błędy i limity

Limity obowiązują na klucz: 5 zapytań na sekundę (krótkie skoki do 10) i 1 000 zapytań dziennie. Licznik dzienny zeruje się o 00:00 UTC. Treść błędu to JSON: {"message": "…"}.

Cache i odświeżanie

• Odpowiedzi mają nagłówki ETag, Last-Modified i Cache-Control: private, max-age=3600.
• Odeślij ostatni ETag w If-None-Match: jeśli nic się nie zmieniło, dostaniesz 304 bez treści.
• Raz dziennie w zupełności wystarczy. Ceny zmieniają się tylko przy naszej zmianie cennika, a dataVersion pokazuje, czy coś się ruszyło.

Wersjonowanie i wycofywanie

• Wersja jest w ścieżce: /v1/.
• Dodanie pól opcjonalnych nie jest zmianą łamiącą i może nastąpić w każdej chwili — ignoruj nieznane pola.
• Usunięcie lub zmiana nazwy pola albo zmiana jego typu lub znaczenia następuje tylko w nowej wersji (/v2/).
• Zanim wersja przestanie działać, piszemy do każdego posiadacza klucza i zapisujemy to w dzienniku zmian co najmniej 90 dni wcześniej.

Dziennik zmian

• 2026-10-22Wydanie v1: GET /v1/plans i GET /v1/schema, klucze API z limitami na partnera, JSON Schema i plik OpenAPI 3.1.

Warunki korzystania

Korzystając z klucza, akceptujesz poniższe zasady:

• Pokazuj cenę końcową z VAT dokładnie tak, jak ją przekazujemy, oraz jednorazową opłatę za eSIM wszędzie tam, gdzie ma zastosowanie (nie jest pobierana między esimFee.waived.from a until).
• Do zakupu kieruj na naszą stronę produktu (url lub localizedUrls) z własnym parametrem utm lub partnerskim.
• Nie odsprzedawaj, nie rozpowszechniaj i nie przekazuj danych osobom trzecim ani nie używaj ich do zasilania innych baz cen.
• Odświeżaj dane co najmniej raz dziennie. Obowiązuje cena w naszej kasie.
• Chroń swój klucz. Możemy wyłączyć klucz, który narusza te zasady lub limity — i powiemy dlaczego.
• Dane udostępniamy w obecnej postaci, bez gwarancji. Nie oferujemy SLA.

Wniosek o dostęp

Napisz, kim jesteś i jak chcesz korzystać z danych. Zwykle odpowiadamy w ciągu dwóch dni roboczych z adresu partner@esimpark.com.

Pomoc i kontakt

• Pytania o klucze, pola lub współpracę: partner@esimpark.com.
• Nie oferujemy SLA, strony statusu ani środowiska testowego. API służy tylko do odczytu, więc możesz bezpiecznie pracować na produkcyjnym endpoincie.
• Brakuje Ci pola albo potrzebujesz innego formatu? Napisz — dodajemy to, czego potrzebują partnerzy.