Ihr API-Schlüssel



Jeder Nutzer hat einen individuellen API-SchlüsselUm diesen zu erhalten oder zu ändern, senden Sie eine Mail an it@viselio.com.Nachdem Ihre Anfrage genehmigt wurde, wird sich unser Technischer Supportmit allen nötigen Informationen an Sie wenden.



Authentifizierung



Die API ist nur über HTTPS-Server zugänglich. Die Authentifizierungerfolgt durch Ihren API-Schlüssel. Jeder API-Schlüssel ist einem Viselio-Nutzerzugeordnet. Ergebnisse aus vorausgegangenen Anfragen basieren auf der Nutzerrolle,an die der jeweilige API-Schlüssel gebunden ist.



Der API-Schlüssel wird über die HTTP-Standardauthentifizierung übertragenund in das Feld "Benutzername" eingegeben. Geben Sie ein beliebiges Passwort, wie beispielsweise "X", in das dafür vorgesehene Feld ein.



API Endpunkte



Für alle API-Anfragen wenden Sie sich an https://a2.viselio.com/über HTTPS. Die aktuelle Version ist v1.



Formate



Momentan werden nur JSON-basierte API's unterstützt.



Durchsatzratenbeschränkung



Jedem Nutzeraccount ist es erlaubt eine beschränkte Zahl von Anfragenüber einen Zeitraum von 10 Minuten zu machen. Dieses Limit basiert auf der Zahl,der zur Vefügung stehenden (Docs Sites) über die das Nutzerkonto verfügt:



Seitenanzahl Durchsatzratenbeschränkung
1 2000 Anfragen alle 10 Minuten
2 3000 Anfragen alle 10 Minuten.
3 oder mehr 4000 Anfragen alle 10 Minuten


Header werden mit jeder API-Antwort zurückgeschickt,um über die aktuelle Durchsatzratenbeschränkung zu berichten:



Einführung



Willkommen bei Viselio als Entwickler! Genau wie Sie, sind auch wir enthusiastische Webentwickler, die es lieben Sachen zu automatisieren.Hier finden Sie eine lückenlose Dokumentation und API-Referenz,um dieses Ziel zu verwirklichen. Wir wünschen Ihnenviel Erfolg beim Programmieren!

API URI = https://a2.viselio.com/API_KEY

Anwendungs-API

Anzahl der Visaarten und Anzahl der Besuche erhalten



Erforderliche Parameter: Office-ID, Reiseziel, Nationalität



Header:



ERHALTEN /SIE_IHREN_API_ZUGANG/öffentlich/Visumarten/Office-ID/1/Reiseziel/cn/Nationalität/ru

{
    "code": 200,
    "status": "success",
    "action": "public:visatypes",
    "method": "get",
    "result": {
        "1": {
            "name": "Tourist",
            "entries_number": {
                "1": {
                    "name": "Single"
                },
                "2": {
                    "name": "Double"
                }
            }
        },
        "2": {
            "name": "Business",
            "entries_number": {
                "1": {
                    "name": "Single"
                },
                "2": {
                    "name": "Double"
                },
                "3": {
                    "name": "Multiple 6 months"
                },
                "4": {
                    "name": "Multiple 1 year"
                }
            }
        }
    }
}

Bearbeitungszeiten erhalten



Erforderliche Parameter: Office-ID, Reiseziel, Nationalität, Visumarten, Anzahl_Einreisen



Header:



ERHALTEN /SIE_IHREN_API_ZUGANG/öffentlich/Bearbeitungszeit/Office-ID/1/Reiseziel/cn/Nationalität/ru

{
    "code": 200,
    "status": "success",
    "action": "public:proctime",
    "method": "get",
    "result": [
        "Standard",
        "Express (2-3 days)",
        "Urgent (24h)"
    ]
}

Liste verschiedener Parameter-IDs



Erforderliche Parameter: Office-ID, Reiseziel, Nationalität



Header:



ERHALTEN /SIE_IHREN_API_ZUGANG/öffentlich/andere/Office-ID/1/Reiseziel/cn/Nationalität/ru

{
    "code": 200,
    "status": "success",
    "action": "public:other",
    "method": "get",
    "result": {
        "marital_status": {
            "1": "Married",
            "2": "Single"
        },
        "accommodation_type": {
            "1": "Hostel",
            "2": "Hotel"
        }
    }
}

Anwendung erstellen



Erforderliche Parameter: E-Mail, Office-ID, Reiseziel, Nationalität, Visumart, Anzahl der Einreisen



Beispiel JSON



POST /YOUR_API_KEY/public/appdata HTTP/1.1
Content-type: application/json



{
    "email": "hello@viselio.com",
    "destination": "CH",
    "office_id": 1,
    "nationality": "DE",
    "visa_type": 1,
    "entries_number": 1,
    "expedited_service": 0,
    "lang": "en",
    "email_send": true,
    "first_name": "Friedrich",
    "middle_name": "von",
    "last_name": "Hans",
    "contact_phone": "49 114567890",
    "contact_address_street": "Strasse",
    "contact_address_number": "456b",
    "contact_address_zip": "11000",
    "contact_address_city": "Munich",
    "contact_address_country": "DE",
    "school_name": "7 Schuller",
    "school_street_name": "Strasse Zwei",
    "school_street_num": "123",
    "school_zip": "10115",
    "school_city": "Berlin",
    "school_country": "DE",
    "school_phone": "49 114567890",
    "marital_status": 1,
    "birth_date": "02.05.2017",
    "birth_city": "Berlin",
    "birth_country": "DE",
    "passport_number": "123456789",
    "passport_valid_from": "02.05.2017",
    "passport_valid_to": "02.05.2018",
    "place_of_issue": "Berlin",
    "entry_date": "02.07.2017",
    "exit_date": "12.07.2017",
    "cities_visit_list": [
        {
            "city_name": "Berlin",
            "date_from": "02.07.2017",
            "date_to": "12.07.2017",
            "accommodation": 1,
            "accommodation_name": "Some hotel",
            "street_name": "Strasse Drei",
            "street_number": "32323",
            "zip": "23423"
        }
    ],
    "shipp_name": "Hans Bulger",
    "shipp_street": "Strasse View",
    "shipp_street_number": "546z",
    "shipp_zip": "10115",
    "shipp_city": "Berlin",
    "shipp_country": "DE"
}

{
    "code": 200,
    "status": "success",
    "action": "public:appdata",
    "method": "post",
    "result": {
        "app_id": "48b61cfc-740c-4003-b26e-aa9c2bbf51bf"
    }
}

Nationalitäten abrufen



Erforderliche Parameter: Content-Type: text/plain; charset=UTF-8



Header:



GET /YOUR_API_KEY/public/nationalites/



     
      {
    "code": 200,
    "status": "success",
    "action": "public:nationalities",
    "method": "get",
    "result": {
        "3": {
            "name": "Albania"
        },
        "11": {
            "name": "Argentina"
        },
        "12": {
            "name": "Armenia"
        },
        "14": {
            "name": "Australia"
        },
        "15": {
            "name": "Austria"
        },
        "21": {
            "name": "Belarus"
        },
        "22": {
            "name": "Belgium"
        },
        "27": {
            "name": "Bolivia"
        },
        "28": {
            "name": "Bosnia And Herzegovina"
        },
        "31": {
            "name": "Brazil"
        },
        "34": {
            "name": "Bulgaria"
        },
        "37": {
            "name": "Cambodia"
        },
        "39": {
            "name": "Canada"
        },
        "44": {
            "name": "Chile"
        },
        "45": {
            "name": "China"
        },
        "48": {
            "name": "Colombia"
        },
        "53": {
            "name": "Costa Rica"
        },
        "55": {
            "name": "Croatia"
        },
        "57": {
            "name": "Cyprus"
        },
        "58": {
            "name": "Czech Republic"
        },
        "59": {
            "name": "Denmark"
        },
        "62": {
            "name": "Dominican Republic"
        },
        "63": {
            "name": "Ecuador"
        },
        "64": {
            "name": "Egypt"
        },
        "65": {
            "name": "El Salvador"
        },
        "68": {
            "name": "Estonia"
        },
        "73": {
            "name": "Finland"
        },
        "74": {
            "name": "France"
        },
        "80": {
            "name": "Georgia"
        },
        "81": {
            "name": "Germany"
        },
        "84": {
            "name": "Greece"
        },
        "89": {
            "name": "Guatemala"
        },
        "97": {
            "name": "Honduras"
        },
        "98": {
            "name": "Hong Kong"
        },
        "99": {
            "name": "Hungary"
        },
        "100": {
            "name": "Iceland"
        },
        "101": {
            "name": "India"
        },
        "102": {
            "name": "Indonesia"
        },
        "105": {
            "name": "Ireland"
        },
        "107": {
            "name": "Israel"
        },
        "108": {
            "name": "Italy"
        },
        "110": {
            "name": "Japan"
        },
        "112": {
            "name": "Jordan"
        },
        "113": {
            "name": "Kazakhstan"
        },
        "117": {
            "name": "Kuwait"
        },
        "120": {
            "name": "Latvia"
        },
        "121": {
            "name": "Lebanon"
        },
        "125": {
            "name": "Liechtenstein"
        },
        "126": {
            "name": "Lithuania"
        },
        "127": {
            "name": "Luxembourg"
        },
        "128": {
            "name": "Macao"
        },
        "129": {
            "name": "Macedonia"
        },
        "132": {
            "name": "Malaysia"
        },
        "133": {
            "name": "Maldives"
        },
        "135": {
            "name": "Malta"
        },
        "141": {
            "name": "Mexico"
        },
        "144": {
            "name": "Monaco"
        },
        "146": {
            "name": "Montenegro"
        },
        "154": {
            "name": "Netherlands"
        },
        "157": {
            "name": "New Zealand"
        },
        "158": {
            "name": "Nicaragua"
        },
        "164": {
            "name": "Norway"
        },
        "165": {
            "name": "Oman"
        },
        "171": {
            "name": "Paraguay"
        },
        "172": {
            "name": "Peru"
        },
        "173": {
            "name": "Philippines"
        },
        "175": {
            "name": "Poland"
        },
        "176": {
            "name": "Portugal"
        },
        "180": {
            "name": "Romania"
        },
        "181": {
            "name": "Russian Federation"
        },
        "195": {
            "name": "Serbia"
        },
        "198": {
            "name": "Singapore"
        },
        "199": {
            "name": "Slovakia"
        },
        "200": {
            "name": "Slovenia"
        },
        "203": {
            "name": "South Africa"
        },
        "116": {
            "name": "South Korea"
        },
        "205": {
            "name": "Spain"
        },
        "206": {
            "name": "Sri Lanka"
        },
        "211": {
            "name": "Sweden"
        },
        "212": {
            "name": "Switzerland"
        },
        "214": {
            "name": "Taiwan"
        },
        "217": {
            "name": "Thailand"
        },
        "229": {
            "name": "Ukraine"
        },
        "230": {
            "name": "United Arab Emirates"
        },
        "231": {
            "name": "United Kingdom"
        },
        "232": {
            "name": "United States"
        },
        "234": {
            "name": "Uruguay"
        },
        "238": {
            "name": "Vietnam"
        }
    }
}


   

Büros abrufen



Erforderliche Parameter: Content-Type: text/plain; charset=UTF-8



Header:



GET /YOUR_API_KEY/public/proctime/offices/


    {
    "code": 200,
    "status": "success",
    "action": "public:offices",
    "method": "get",
    "result": {
        "1": {
            "city": "Bern",
            "country": "Switzerland"
        },
        "2": {
            "city": "Berlin",
            "country": "Germany"
        },
        "3": {
            "city": "Vienna",
            "country": "Austria"
        },
        "4": {
            "city": "Paris ",
            "country": "France"
        },
        "5": {
            "city": "London",
            "country": "United Kingdom"
        }
    }
}

Ziele abrufen



Erforderliche Parameter: office_id



Header:



GET /YOUR_API_KEY/public/destinations/office_id/1


    {
    "code": 200,
    "status": "success",
    "action": "public:destinations",
    "method": "get",
    "result": {
        "4": {
            "name": "Algeria"
        },
        "7": {
            "name": "Angola"
        },
        "11": {
            "name": "Argentina"
        },
        "16": {
            "name": "Azerbaijan"
        },
        "18": {
            "name": "Bahrain"
        },
        "19": {
            "name": "Bangladesh"
        },
        "24": {
            "name": "Benin"
        },
        "31": {
            "name": "Brazil"
        },
        "35": {
            "name": "Burkina Faso"
        },
        "36": {
            "name": "Burundi"
        },
        "37": {
            "name": "Cambodia"
        },
        "38": {
            "name": "Cameroon"
        },
        "40": {
            "name": "Cape Verde"
        },
        "45": {
            "name": "China"
        },
        "51": {
            "name": "Congo, Democratic Republic"
        },
        "54": {
            "name": "Cote D'Ivoire"
        },
        "62": {
            "name": "Dominican Republic"
        },
        "64": {
            "name": "Egypt"
        },
        "69": {
            "name": "Ethiopia"
        },
        "78": {
            "name": "Gabon"
        },
        "79": {
            "name": "Gambia"
        },
        "82": {
            "name": "Ghana"
        },
        "101": {
            "name": "India"
        },
        "102": {
            "name": "Indonesia"
        },
        "105": {
            "name": "Ireland"
        },
        "107": {
            "name": "Israel"
        },
        "110": {
            "name": "Japan"
        },
        "112": {
            "name": "Jordan"
        },
        "113": {
            "name": "Kazakhstan"
        },
        "114": {
            "name": "Kenya"
        },
        "117": {
            "name": "Kuwait"
        },
        "118": {
            "name": "Kyrgyzstan"
        },
        "121": {
            "name": "Lebanon"
        },
        "130": {
            "name": "Madagascar"
        },
        "131": {
            "name": "Malawi"
        },
        "134": {
            "name": "Mali"
        },
        "145": {
            "name": "Mongolia"
        },
        "149": {
            "name": "Mozambique"
        },
        "150": {
            "name": "Myanmar"
        },
        "151": {
            "name": "Namibia"
        },
        "153": {
            "name": "Nepal"
        },
        "159": {
            "name": "Niger"
        },
        "160": {
            "name": "Nigeria"
        },
        "165": {
            "name": "Oman"
        },
        "166": {
            "name": "Pakistan"
        },
        "181": {
            "name": "Russian Federation"
        },
        "182": {
            "name": "Rwanda"
        },
        "198": {
            "name": "Singapore"
        },
        "116": {
            "name": "South Korea"
        },
        "206": {
            "name": "Sri Lanka"
        },
        "207": {
            "name": "Sudan"
        },
        "214": {
            "name": "Taiwan"
        },
        "215": {
            "name": "Tajikistan"
        },
        "216": {
            "name": "Tanzania"
        },
        "217": {
            "name": "Thailand"
        },
        "219": {
            "name": "Togo"
        },
        "224": {
            "name": "Turkey"
        },
        "228": {
            "name": "Uganda"
        },
        "229": {
            "name": "Ukraine"
        },
        "235": {
            "name": "Uzbekistan"
        },
        "237": {
            "name": "Venezuela"
        },
        "238": {
            "name": "Vietnam"
        },
        "244": {
            "name": "Zambia"
        },
        "245": {
            "name": "Zimbabwe"
        }
    }
}

Anforderungen API

Alle Nationalitäten erhalten



Header:



GET https://r.viselio.com/api/allNationalities/4597065b0f5abc60b0311cf28f317229

{
      "code": 200,
      "status": "success",
      "action": "public:other",
      "method": "get",
      "result": 
              {
                "id":"1",
                "name":"Afghanistan"
              },
              {
                "id":"3",
                "name":"Albania"
              },
              {
                "id":"4",
                "name":"Algeria"
              },
              {
                "id":"6",
                "name":"Andorra"
              },
              {
                "id":"7",
                "name":"Angola"
              },
              {
                "id":"8",
                "name":"Anguilla"
              }...
  }

Überprüfen Sie, ob der Nutzer ein Visum benötigt



Erforderliche Parameter: country_from_id, country_to_id



Header:



GET https://r.viselio.com/api/timShort/4597065b0f5abc60b0311cf28f317229/country_from_id/country_to_id

{
  "data":{
    "note_en":"Please contact office.",
    "visa_required":"Yes"
  }
}

Preisberechnung abrufen



Erforderliche Parameter: office_id, destination, nationality, visa_type, entries_number, expedited_service



Header:



GET /API_KEY/public/prices/office_id/1/destination/cn/nationality/ru/visa_type/1/entries_number/1/expedited_service/0 HTTP/1.1

{
                        "code": 200,
                        "status": "success",
                        "action": "public:prices",
                        "method": "get",
                        "result": {
                            "without_vat": {
                                "price_total": 109.6379,
                                "price_ambassy_fee": 40,
                                "price_vsh_fee": 0,
                                "price_fee": 69.6379
                            },
                            "with_vat": {
                                "price_total": 115,
                                "price_ambassy_fee": 40,
                                "price_vsh_fee": 0,
                                "price_fee": 75
                            },
                            "vat_percent": 7.7,
                            "currency": "CHF"
                          }
                        }