Užitočné nástroje

Prostredníctvom služby Swiftyper Utils API je možné overiť správnosť e-mailovej adresy a IČ DPH, preložiť text medzi jazykmi a získať informácie o IP adrese.

POST/v1/utils/email/validate

Overenie e-mailovej adresy

Overenie platnosť e-mailovej adresy, zistiť jednorazové alebo dočasné e-maily, a ďalšie informácie o e-mailovej adrese.

Povinné parametre

  • Name
    email
    Type
    string
    Description

    E-mailová adresa, ktorú chcete overiť.

  • Name
    api_key
    Type
    string
    Description

    Prístupový API kľúč môžete použiť ako parameter api_key alebo v hlavičke požiadavky X-Swiftyper-API-Key.

Výstup

Výstupom je objekt s popísanými atribútmi. V prípade chyby alebo nesprávnosti parametrov sa zobrazí chyba. Bežným zdrojom chýb je nezadanie API kľúču, alebo presiahnutie mesačného limitu na dopytovanie.

Požiadavka

curl -X POST https://api.swiftyper.sk/v1/utils/email/validate \
   -H 'X-Swiftyper-API-Key: VÁŠ_API_KĽÚČ' \
   -d email="help@planetexpress.com"

Odpoveď

{
  "email_id": "NHleJ3IbgbUdQ-bQMI2Bxg",
  "email": "help@planetexpress.com",
  "username": "help",
  "domain": "planetexpress.com",
  "reachable": "risky",
  "disposable": false,
  "roleAccount": true,
  "mxValid": true,
  "connection": true,
  "inboxFull": false,
  "catchAll": false,
  "deliverable": true,
  "disabled": false,
  "free": false,
  "took": 0.410547924041748
}
POST/v1/utils/translator/translate

Prekladač textu

Prekladač textu je určený na preklad textu medzi jazykmi. V súčasnosti podporuje viac ako 100 jazykov.

Povinné parametre

  • Name
    q
    Type
    string
    Description

    Text, ktorý chcete preložiť.

  • Name
    sl
    Type
    string
    Description

    Zdrojový jazyk (napr. en).

  • Name
    tl
    Type
    string
    Description

    Cieľový jazyk (napr. sk).

  • Name
    api_key
    Type
    string
    Description

    Prístupový API kľúč môžete použiť ako parameter api_key alebo v hlavičke požiadavky X-Swiftyper-API-Key.

Výstup

Výstupom je objekt s popísanými atribútmi. V prípade chyby alebo nesprávnosti parametrov sa zobrazí chyba. Bežným zdrojom chýb je nezadanie API kľúču, alebo presiahnutie mesačného limitu na dopytovanie.

Požiadavka

curl -X POST https://api.swiftyper.sk/v1/utils/translator/translate \
   -H 'X-Swiftyper-API-Key: VÁŠ_API_KĽÚČ' \
   -d q="Hello world" \
   -d sl="en" \
   -d tl="ja"

Odpoveď

{
    "translation": "こんにちは世界"
}
GET/v1/utils/ip/{ip_address}

Detaily IP adresy

Slúži na získanie informácií o IP adrese.

Povinné parametre

  • Name
    ip_address
    Type
    string
    Description

    IP adresa.

  • Name
    api_key
    Type
    string
    Description

    Prístupový API kľúč môžete použiť ako parameter api_key alebo v hlavičke požiadavky X-Swiftyper-API-Key.

Výstup

Výstupom je objekt s popísanými atribútmi. V prípade chyby alebo nesprávnosti parametrov sa zobrazí chyba. Bežným zdrojom chýb je nezadanie API kľúču, alebo presiahnutie mesačného limitu na dopytovanie.

Požiadavka

curl -X GET https://api.swiftyper.sk/v1/utils/ip/1.1.1.1 \
   -H 'X-Swiftyper-API-Key: VÁŠ_API_KĽÚČ'

Odpoveď

  {
      "ip": "1.1.1.1",
      "hostname": "one.one.one.one",
      "city": "Brisbane",
      "region": "Queensland",
      "country_code": 'AU",
      "latitude": -27.4816,
      "longitude": 153.0175,
      "org": "AS13335 Cloudflare, Inc.",
      "postal": "4101",
      "timezone": "Australia/Brisbane"
  }
POST/v1/utils/vies/check-vat-number

Overenie IČ DPH (EÚ)

Overte platnosť IČ DPH firmy v EÚ pomocou systému VIES. Hodí sa pre fakturáciu alebo registráciu partnerov.

Povinné parametre

  • Name
    countryCode
    Type
    string
    Description

    Kód krajiny, v ktorej je registrovaný dodávateľ.

  • Name
    vatNumber
    Type
    string
    Description

    IČ DPH dodávateľa.

  • Name
    api_key
    Type
    string
    Description

    Prístupový API kľúč môžete použiť ako parameter api_key alebo v hlavičke požiadavky X-Swiftyper-API-Key.

Výstup

Výstupom je objekt s popísanými atribútmi. V prípade chyby alebo nesprávnosti parametrov sa zobrazí chyba. Bežným zdrojom chýb je nezadanie API kľúču, alebo presiahnutie mesačného limitu na dopytovanie.

Požiadavka

curl -X POST https://api.swiftyper.sk/v1/utils/vies/check-vat-number \
-H 'X-Swiftyper-API-Key: VÁŠ_API_KĽÚČ' \
     -d countryCode="SK" \
     -d vatNumber="2023227459"

Odpoveď

{
    "countryCode": "SK",
    "vatNumber": "2023227459",
    "requestDate": "2024-01-07T15:40:34.647Z",
    "valid": true,
    "requestIdentifier": "",
    "name": "Google Slovakia, s. r. o.",
    "address": "Karadžičova 8/A\n82108 Bratislava - mestská časť Ružinov\nSlovensko",
    "traderName": "---",
    "traderStreet": "---",
    "traderPostalCode": "---",
    "traderCity": "---",
    "traderCompanyType": "---",
    "traderNameMatch": "NOT_PROCESSED",
    "traderStreetMatch": "NOT_PROCESSED",
    "traderPostalCodeMatch": "NOT_PROCESSED",
    "traderCityMatch": "NOT_PROCESSED",
    "traderCompanyTypeMatch": "NOT_PROCESSED",
    "object": "vies"
}