Vyberte jazyk

Klíče API a zabezpečení

Rozsahy, seznamy povolených IP adres, denní limity útraty, platnost, rotace bez výpadku a co dělat, když klíč unikne.

Na této stránce
  1. Formát klíče
  2. Omezte, co každý klíč smí
  3. Potvrzování citlivých změn
  4. Rotace bez výpadku
  5. Zneplatnění
  6. Když klíč unikne
  7. Co zaznamenáváme
  8. Nikdy z prohlížeče

Klíč API může dělat vše, co mu jeho rozsahy dovolí, a platí přitom z vašeho zůstatku. Zacházejte s ním jako s heslem.

Formát klíče

Klíče vypadají jako sgk_ následované 40 písmeny a číslicemi. SmsGrab ukládá jen otisk každého klíče, takže se klíč zobrazí jednou, při vytvoření nebo rotaci, a pak už nikdy. Ve svém účtu vidíte jen jeho začátek a poslední čtyři znaky.

Omezte, co každý klíč smí

Při vytváření nebo úpravě klíče ho můžete omezit:

Nastavení Co dělá
Rozsahy read pro zůstatek, katalog, ceny, aktivace a využití; read a purchase také pro nákup, rušení a dokončování
Seznam povolených IP Až 50 adres IPv4 nebo IPv6 či rozsahů CIDR; požadavky z jiných adres se odmítnou
Denní limit útraty Nejvíc, co smí tento klíč utratit (netto) za den UTC; nad tuto hranici se nákupy odmítají a nic se nestrhne
Platnost Volitelné datum, po kterém klíč přestane fungovat, nejvýše 2 roky dopředu

Používejte jeden klíč pro každou aplikaci nebo server, s co nejmenšími potřebnými rozsahy. Účet může mít až 10 aktivních klíčů.

Potvrzování citlivých změn

Vytvoření klíče, jeho rotace, přidání webhooku, výměna tajného klíče webhooku a uvolnění klíče (více rozsahů, širší seznam IP, vyšší limit nebo pozdější konec platnosti) vyžadují znovu heslo, a pokud je zapnuté dvoufázové ověření, i jeho kód. Potvrzení platí 5 minut. Zneplatnění klíče a zpřísnění jeho limitů nic takového nevyžadují.

Rotace bez výpadku

Rotace dá klíči nový tajný údaj a zachová jeho nastavení, využití a webhooky. Zvolíte přechodné období až 72 hodin, během kterého starý údaj stále funguje, takže můžete servery aktualizovat bez přerušení.

Zneplatnění

Zneplatnění klíč zastaví okamžitě a natrvalo. Vypnou se i jeho webhooky.

Když klíč unikne

  1. Zneplatněte ho, nebo proveďte rotaci s přechodným obdobím 0 hodin.
  2. Zkontrolujte protokol požadavků klíče (posledních 7 dní) a svou Peněženku, jestli v nich není aktivita, kterou nepoznáváte.
  3. Vytvořte nový klíč se seznamem povolených IP a denním limitem útraty.

Co zaznamenáváme

Klíče se nikdy neobjeví v žádném protokolu. U každého požadavku uchováváme 7 dní čas, cestu, stav, dobu trvání a identifikátor požadavku a vy je vidíte u každého klíče. Vytvoření, rotace a zneplatnění klíčů se objeví i v aktivitě účtu a každý nový klíč vyvolá oznámení.

Nikdy z prohlížeče

API nepřijímá volání z webových stránek (CORS není k dispozici). Volejte ho jen ze svých vlastních serverů.

Pomohl vám tento článek?

Stále potřebujete pomoc?

Napište nám. Odpovídáme na každou zprávu, obvykle během několika hodin.

Nebo nám napište na support@smsgrab.com