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.



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"
    }
}

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"
  }
}

Get price calculation



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"
    }
}