Partnerské API OvěřeníTelefonu.cz

Napojte ověření IMEI a sériových čísel přímo do svého systému. Partnerské REST API pokrývá katalog služeb, jednotlivé i hromadné kontroly, výsledky a zůstatek peněženky — s velkoobchodní cenou podle vašeho plánu.

Autentizace API klíčem

Každý request se ověřuje partnerským API klíčem v hlavičce Authorization: Bearer. Klíč je vázaný na váš účet a plán.

Jednotlivé i hromadné kontroly

Ověřte jedno zařízení, nebo pošlete celou dávku IMEI jedním requestem přes /batch (od plánu Gold).

Zůstatek a limity

Endpoint /balance vrací zůstatek peněženky, aktuální plán a zbývající denní limit kontrol.

Strukturované chyby

Chyby vrací stabilní kódy (api_key_required, rate_limited, batch_not_enabled …) pro spolehlivou integraci.

Přehled endpointů

Metoda	Endpoint	Popis
GET	`/api/partner/unlocker/v1/services`	Katalog služeb s cenou pro váš plán
POST	`/api/partner/unlocker/v1/checks`	Spustit kontrolu jednoho zařízení
GET	`/api/partner/unlocker/v1/checks/{id}`	Získat výsledek kontroly
POST	`/api/partner/unlocker/v1/batch`	Hromadná kontrola více identifikátorů
GET	`/api/partner/unlocker/v1/balance`	Zůstatek peněženky a denní limit

Plány, limity a přístup

Přístup k API a hromadným kontrolám i denní limit se řídí vaším partnerským plánem. Velkoobchodní sleva se promítá do ceny každé kontroly v katalogu.

Free

Denní limit: 3 kontrol
Přístup k API: ne
Hromadné /batch: ne

Silver

Denní limit: 20 kontrol
Přístup k API: ano
Hromadné /batch: ne

Gold

Denní limit: 50 kontrol
Přístup k API: ano
Hromadné /batch: ano

Platinum

Denní limit: 100 kontrol
Přístup k API: ano
Hromadné /batch: ano

Získejte partnerský API klíč

Vydání klíče je samoobslužné z partnerského účtu. Potřebujete poradit s integrací? Napište nám na support@tvojedata.cz.

Otevřít dokumentaci Řešení pro bazary