Přeskočit na hlavní obsah

Validace telefonního čísla v API

Pro ověření, zda telefonní číslo existuje, můžete využít naše klasické API pro odesílání zpráv.

Vložte do parametru flow objekt number_verify:

...
  "flow": [
    {
      "number_verify": {
        "gateway": "default"
      }
    }
  ]
...

Výsledek ověření obdržíte na URL, kterou definujete v rámci atributu callback.

Příklad​

{
  "callback": "https://mojefiremni.com/callback",
  "flow": [
    {
      "number_verify": {
        "gateway": "default"
      }
    }
  ],
  "to": [
    {
      "phone_number": "420777123456"
    }
  ]
}

Callback​

[
  {
    "request_id": "72a2ac84-1438-40c3-a134-d44b94cbc744",
    "message_id": "a129c7fc-8843-45b3-a4b3-56a79c5e3c35",
    "gateway": "number_verify",
    "timestamp": 1753732119,
    "type": "outgoing",
    "to": {
      "phone_number": "420777123456"
    },
    "result": "sent",
    "number_verify": {
      "country": 230,
      "operator": 3,
      "price_czk": 0.19,
      "price_eur": 0.008,
      "count": 1
    }
  }
]

FAQ​

Jak poznám, že je telefonní číslo ověřené?​

Pokud obdržíte v JSON odpovědi status=sent, jedná se o telefonní číslo, které je platné. V případě, že obdržíte status=failed, znamená to, že je telefonní číslo neplatné.

Co znamená platné číslo?​

Jedná se o telefonní číslo, které je schopné momentálně přijmout váš hovor nebo SMS zprávu. Pokud se jedná o neexistující telefonní číslo, obdržíte status=failed.

Stejný status obdržíte i v případě, že je telefonní číslo vypnuté nebo odpojené. Pozor, stav čísla se může měnit, ale další notifikaci již neobdržíte (např. po zapnutí přístroje).

Co když je telefonní číslo vypnuté a má nastavené přesměrování hovorů?​

V takovém případě obdržíte status=failed.

Může se stát, že je telefonní číslo nedostupné a přesto obdržím status=sent?​

Ano. Obvykle se jedná o případy, kdy bylo telefonní číslo ještě nedávno dostupné, nicméně nyní je odpojené a zároveň není uvolněné pro další zákazníky.

Obvykle ale, pokud obdržíte chybu (tedy status=failed) lze telefonní číslo opravdu považovat za nedostupné (jedná se o typické "false positive").

Je výsledek garantován?​

Bohužel ne. V současnosti neexistuje 100% spolehlivý zdroj dat, nicméně poskytujeme to nejlepší, co je v rámci mezinárodní mobilní sítě dostupné. Pokud potřebujete službu nejprve vyzkoušet, prosím, kontaktujte nás.

Lze službu vyzkoušet?​

Ano. Kontaktujte nás prosím s vaším požadavkem. Můžeme vám bezplatně poskytnout testovací vzorek vašich dat pro ověření, zda vám spolehlivost vyhovuje a je pro vás služba užitečná. Nabízíme ještě další netypické parametry pro hodnotu gateway, které je možné vyzkoušet pro lepší výsledky (jiné hodnoty mohou být účtovány vyšší sazbou a ne vždy je vhodné je použít. Proto kompletní číselník veřejně nepublikujeme).