CheckWarranty.info
REST API v1 & Webhooks dla DevOps, ITAM i Integratorów

Zautomatyzuj sprawdzanie gwarancji i fabrycznej specyfikacji IT przez REST API

Pojedyncze i masowe zapytania (do 500 urządzeń na request). Połącz CheckWarranty ze Snipe-IT, NetBox, ServiceNow, Jira, Subiektem lub Comarch ERP w 15 minut. Zgodność z OpenAPI 3.1 i pełna idempotencja.

Standardy integracji:REST JSON•Bearer Token Auth•Idempotency-Key Header•OpenAPI 3.1 / Swagger•Zero-Risk Billing

Wydajna architektura stworzona dla inżynierów

Zapomnij o niestabilnych parserach HTML i blokadach IP. Nasze API dostarcza ustrukturyzowane dane prosto do Twojej bazy.

⚡Do 500 sztuk / request

Hurtowe zapytania zbiorcze (Bulk Scan)

Przesyłaj tablice numerów seryjnych w jednym wywołaniu HTTP. Silnik CheckWarranty równolegle odpytuje rejestry producentów, optymalizując czas przetwarzania partii.

🛡️RFC 9457 & Safe Retries

Bezpieczna idempotencja (Idempotency-Key)

Nagłówek Idempotency-Key chroni przed podwójnym naliczeniem kredytów w przypadku problemów sieciowych, ponowień webhooków czy restartu mikroserwisów.

📦Dell • Lenovo • HP • Apple

Ujednolicony format JSON (4 producenci)

Jeden znormalizowany model odpowiedzi dla wszystkich marek. Daty gwarancji, kody SLA, statusy wsparcia oraz specyfikacja BOM (CPU, RAM, SSD, matryca) w czytelnej strukturze JSON.

🔒99.9% Uptime

WAF Defense & Wysokie SLA

Inteligentne zarządzanie pulami połączeń i automatyczne omijanie blokad producentów (Akamai, Cloudflare, reCAPTCHA). Twoja integracja działa stabilnie 24/7.

Prosta integracja w dowolnym języku

Przykładowe wywołanie masowego skanowania przez cURL oraz odpowiedź w ujednoliconym formacie JSON.

Żądanie HTTP (POST /api/scans)cURL
curl -X POST https://checkwarranty.info/api/scans \
  -H "Authorization: Bearer cw_live_YOUR_API_KEY" \
  -H "Idempotency-Key: batch-2026-11-04-001" \
  -H "Content-Type: application/json" \
  -d '{
    "brand": "dell",
    "serials": ["8B4J2Y3", "3P9K1X2"]
  }'
Odpowiedź (200 OK)JSON
{
  "batchId": "bch_98f12a34",
  "status": "completed",
  "results": [
    {
      "serial": "8B4J2Y3",
      "brand": "dell",
      "productName": "Latitude 5520",
      "warrantyStatus": "Active",
      "warrantyEndDate": "2027-04-15",
      "serviceLevel": "ProSupport Plus NBD Onsite",
      "specs": {
        "cpu": "Intel Core i7-1185G7",
        "ram": "16GB DDR4 3200MHz",
        "storage": "512GB NVMe PCIe SSD",
        "display": "15.6 FHD (1920x1080) IPS"
      }
    }
  ]
}
Dostępne SDK i biblioteki: Python, Node.js/TypeScript, Go, PHP.Zobacz pełną dokumentację parametrów API →

Najczęstsze scenariusze wdrożenia w firmach

Jak polskie zespoły ITAM, DevOps oraz działy wsparcia wykorzystują nasze API w codziennej pracy.

Snipe-IT / NetBox (ITAM & DCIM)

Automatyczne uzupełnianie daty wygaśnięcia gwarancji i specyfikacji sprzętowej w polach niestandardowych (Custom Fields) przy przyjęciu nowego lub poleasingowego sprzętu do firmy.

Jira Service Management / ServiceNow

Błyskawiczna weryfikacja uprawnień do naprawy (ProSupport / Care Pack / Premier) w momencie rejestracji incydentu awarii przez pracownika w portalu helpdesk.

Subiekt GT/Nexo / Comarch ERP Optima

Zaczytywanie danych technicznych (procesor, pamięć, pojemność dysku) do kartotek towarowych podczas skanowania kodów na dokumencie magazynowym PZ.

Skrypty Python / Bash / Cron

Cykliczny skan floty komputerowej firmy w celu wykrycia urządzeń, którym gwarancja kończy się w ciągu najbliższych 30–60 dni i zaplanowania odnowienia wsparcia.

Zero-Risk Developer Policy

Brak opłat za błędy i nieznalezione numery

Przy integracjach API nie musisz martwić się utratą środków przez literówki w numerach seryjnych. Kredyty są pobierane wyłącznie za zapytania, które zwróciły użyteczne dane o urządzeniu.

  • ✔ Błędny format lub brak rekordu w rejestrze producenta = natychmiastowe zwolnienie rezerwacji kredytu.
  • ✔ Ponowienie zapytania z tym samym Idempotency-Key nie powoduje ponownego naliczenia.
  • ✔ Pakiety kredytowe nigdy nie przepadają (brak wymogu miesięcznego abonamentu).

Pytania techniczne (FAQ)

Wszystko, co musisz wiedzieć przed rozpoczęciem integracji.

Jakie są limity zapytań (Rate Limits) w REST API?

Standardowy limit wynosi 60 zapytań na minutę (RPM) oraz do 500 numerów seryjnych w pojedynczym zapytaniu wsadowym (bulk). Dla klientów Enterprise z dedykowanymi pulami proxy limity mogą zostać zwiększone w zależności od potrzeb.

Jak działa mechanizm autoryzacji?

Autoryzacja odbywa się za pomocą standardowego tokena Bearer w nagłówku HTTP: `Authorization: Bearer cw_live_...`. Klucze API można wygenerować i unieważnić w panelu klienta w zakładce API Keys.

Czy API obsługuje automatyczne rozpoznawanie marki (Auto-Detect)?

Tak. W dedykowanym punkcie końcowym `/api/scans/auto-detect` wystarczy przesłać numer seryjny, a silnik CheckWarranty automatycznie rozpozna wzorzec producenta (np. 7-znakowy Service Tag Dell, prefiksy Lenovo czy format numerów Apple).

Jak rozliczane są wywołania API (Zero-Risk)?

Każde pomyślne sprawdzenie, które zwróci użyteczne dane o urządzeniu (gwarancję lub fabryczną specyfikację), pobiera 1 kredyt z salda konta. Jeśli urządzenie nie istnieje w bazie producenta lub nie zwrócono żadnych użytecznych danych, zarezerwowane kredyty są natychmiast zwalniane. Kredyty nigdy nie tracą ważności.

Gdzie znajduje się pełna specyfikacja OpenAPI (Swagger)?

Publiczna specyfikacja OpenAPI 3.1 jest dostępna pod adresem /openapi.json oraz w interaktywnej dokumentacji /pl/docs/api.