Vitec Software Group
Express Connect Tjänster är ett flöde för att exponera tjänster av tjänsteleverantörer direkt i Vitec Express.
Om t. ex. en användare vill att en expertfotograf ska ta bilder på ett hus, eller beställa marknadsföringsmaterial av en partner. För att förenkla beställningsarbetet och leveransen för användarna så kan ni integrera era tjänster i Express Connect.
Börja med att registrera er i vår Connectportal.
Meddela oss på Vitec med följande information genom att klicka här:
Fundera gärna också på vilka metoder det är ni skulle behöva nyttja i Connect.
Tokenbaserad autentisering innebär att vi genererar en token och skickar med i alla anrop till er. Tokenet skickas som en parameter i URL:en tillsammans med ett kund-id (customerId).
https://my-service.example/order?customerId=M123&token=B2aJbxq%2FHPX567%2F8QBjwuGxKtL1wcDF9amnY%2BJLe1BEff7qWesnZvw%3D%3D
För att få ut beställningsparametrarna så anropa Connect via denna metod
Autentisering med basic authentication, fungerar endast med asynkront flöde och används endast vid initiala anropet.
Vi skickar parametrarna direkt i URL:en.
För bättre autentiseringskydd så rekommenderar vi tokenbaserade autentiseringen. Den skyddar dessutom alla anrop och inte enbart initiala anropet.
Ingen autentisering, vi skickar parametrarna direkt i URL:en.
Vi öppnar en ny sida hos er i samband med att användaren utför beställningen.
URL:en kan anropas upprepade gånger för samma order id. Ger möjlighet att användare kan gå tillbaka till eran sida efter beställningsförfarandet.
Ni kommer att behöva skicka ett anrop till Connect efter ni tagit emot beställningen där ni sätter order status till mottagen (OrderReceived) via denna metod.
Har ni ingen sida att visa i första läget, så kan ni använda detta bakgrundsflöde. Ni kan fortfarande skicka en länk som användaren kan öppna via användarinteraktionen i ett senare läge.
Beställningen kommer automatiskt sättas som mottagen (OrderReceived) efter vi har tagit emot ert svar.
Det första anropet ni får är när vi kontaktar er angående en beställning. Ni kommer i samband med anropet få information om vad beställningen rör.
För bostäder så kommer ni att få följande information i anropet:
Via URL parametrar.
Via Connect
Via URL parametrar.
Vi vill att ni svarar med statuskod 200 så fort att ni har säkerställt att ni tagit emot beställningen, gärna innan ni har påbörjat behandlingen av beställningen.
T. ex. börja med att lagra beställningen i databasen, starta sedan en ny tråd som får behandla beställningen och svara sedan med statuskod 200.
Skulle det bli något fel som gör att det inte gör att slutföra beställningen så kan ni meddela användaren det genom att anropa Connect och uppdatera status på beställningen. Metoden för att uppdatera status finns här. Ange status "Error" och skicka med en beskrivning av felet.
Vissa problem kan användaren lösa och istället för att sätta status på beställningen till fel, så kan ni begära en interaktion av användaren.
Det är också lämpligt att kräva en interaktion av användaren om användaren behöver göra val i beställningen.
Metoden för att kräva en användarinteraktion finns här.
Ni anger en URL och en beskrivning som presenteras vid länken.
Om det är lämpligt för er tjänst så kan ni leverera resultatet direkt till användaren genom att anropa Connect. Efter beställningen är färdig, så kan ni meddela användaren genom att sätta status till "Delivered".