Dlaczego nasze API?
⚡ Szybkie
Odpowiedzi w czasie < 100ms. Zoptymalizowane zapytania i indeksy bazodanowe.
🔒 Bezpieczne
HTTPS, autoryzacja przez klucze API, monitoring i logowanie zapytań.
📊 Aktualne
Regularnie aktualizowana baza kodów pocztowych z całej Polski.
💡 Proste
Intuicyjne REST API z dokumentacją i przykładami użycia.
Cennik
Starter
49.00 PLN
- 1,000 zapytań
- Ważność: 30 dni
- Wsparcie techniczne
- HTTPS
- Dokumentacja API
Professional
199.00 PLN
- 10,000 zapytań
- Ważność: 90 dni
- Wsparcie techniczne
- HTTPS
- Dokumentacja API
Enterprise
799.00 PLN
- 100,000 zapytań
- Ważność: 365 dni
- Wsparcie techniczne
- HTTPS
- Dokumentacja API
Przykład użycia
Prosty przykład wyszukiwania kodów pocztowych:
GET
https://kodypocztowe.ict-systems.pl/api/v1/search?code=00-001
// Przykład w PHP
$apiKey = 'TWOJ_KLUCZ_API';
$code = '00-001';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://kodypocztowe.ict-systems.pl/api/v1/search?code=$code");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"X-API-Key: $apiKey"
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);
// Przykład odpowiedzi JSON
{
"success": true,
"data": [
{
"code": "00-001",
"city": "Warszawa",
"street": "Aleje Jerozolimskie",
"voivodeship": "mazowieckie",
"county": "Warszawa",
"commune": "Śródmieście"
}
],
"count": 1
}
Dokumentacja API
Wszystkie zapytania wymagają nagłówka autoryzacyjnego:
X-API-Key: TWOJ_KLUCZ_API
Dostępne endpointy:
GET
/api/v1/search?code=XX-XXX
Wyszukiwanie po kodzie pocztowym
GET
/api/v1/search?city=Warszawa
Wyszukiwanie po nazwie miasta
GET
/api/v1/search?street=Piotrkowska&city=Łódź
Wyszukiwanie po ulicy i mieście
GET
/api/v1/stats
Statystyki użycia Twojego klucza API