B2B REST API v1 & Webhooks

Dokumentacja REST API CheckWarranty

Zautomatyzuj sprawdzanie gwarancji i fabrycznej specyfikacji sprzętu (As-Built BOM) w swoim systemie ERP, magazynowym WMS lub platformie ITAM.

Szybki start

Autoryzacja kluczem API i pierwsze zapytanie w cURL lub Pythonie w mniej niż 2 minuty.

Do 500 pozycji w partii

Masowe zapytania batchowe dla hurtowni i serwisów z asynchronicznym statusem.

Webhooki i powiadomienia

Odbieraj powiadomienia o zakończeniu skanowania bezpośrednio w swoim backendzie.

1. Uwierzytelnianie (API Key)

Wszystkie żądania do API wymagają podania klucza API w nagłówku HTTP Authorization. Klucze możesz wygenerować w panelu klienta w zakładce Klucze API.

# Przykład nagłówka HTTP
Authorization: Bearer cw_live_xxxxxxxxxxxxxxxxxxxxxxxx

2. Pojedyncza weryfikacja (Single Lookup)

Punkt końcowy do natychmiastowego sprawdzenia jednego urządzenia (Dell, Lenovo, HP lub Apple):

POST https://api.checkwarranty.info/v1/scans

Przykład żądania (cURL)

curl -X POST https://api.checkwarranty.info/v1/scans \
  -H "Authorization: Bearer $CHECKWARRANTY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "serial": "5CG1234XYZ",
    "brand": "hp"
  }'

Przykładowa odpowiedź (JSON)

{
  "success": true,
  "serial": "5CG1234XYZ",
  "brand": "hp",
  "model": "HP EliteBook 840 G8",
  "warranty": {
    "status": "active",
    "startDate": "2022-04-15T00:00:00Z",
    "endDate": "2025-04-14T00:00:00Z",
    "coverageType": "HP Care Pack Next Business Day Onsite"
  },
  "specs": {
    "cpu": "Intel Core i7-1165G7",
    "ram": "16GB DDR4",
    "storage": "512GB NVMe SSD",
    "display": "14.0 FHD IPS Anti-Glare"
  },
  "creditsRemaining": 489
}

3. Przetwarzanie masowe (Bulk Batch)

Dla partii od kilkudziesięciu do 500 numerów seryjnych użyj punktu masowego. API przetwarza urządzenia równolegle i zwraca identyfikator partii batchId:

POST https://api.checkwarranty.info/v1/scans/bulk

Status partii możesz odpytywać metodą GET /v1/scans/bulk/{batchId} lub skonfigurować webhook dla natychmiastowego powiadomienia po ukończeniu.

Gotowe integracje dla Twojego zespołu

Zobacz gotowe szablony i skrypty synchronizacji dla Snipe-IT, NetBox, GLPI oraz Google Sheets.

Poznaj integracje