Autentiseringsalternativ
Spara aldrig referenser i klartext.
Autentisering genom JWT
Du måste autentisera dig när du interagerar med vårt API. Alla Open API-förfrågningar använder Bearer-autentisering med JSON Web Tokens (se RFC 7519).
Klienten måste ställa in Auktoriseringshuvudet till ‘Bearer <token>’.
Token är personlig och unik för varje användare och en specifik domän, enligt vad som indikeras vid skapandet.
Autentisering genom grundläggande autentisering
Vi rekommenderar JWT-tokens för autentisering, men vi stöder också BasicAuth. Se RFC 7617. När en administratör eller tredjepartsapplikation behöver dina Ping-uppgifter kan tillhandahållande av en JWT användas som ett säkrare alternativ.
Exempel:
A request to this endpoint with the HTTP header ‘Authorization: Bearer <json.web.token>’ will authenticate the request to ‘/calls’ for the user.
A request to “/auth/login” with the HTTP header ‘Authorization: Basic MDEyMzQ1Njc4OnZlcnlzZWNyZXQ=’ will make the user with the username “012345678” and the password “verysecret” login, and return a cookie for future Authentication.
Exempel:
https://admin.pingaway.se/api/extensions/
Retrieve information about all available extension.
https://admin.pingaway.se/api/extensions/me
Retrieve the currently authenticated user’s extension.
https://admin.pingaway.se/api/extensions/08123456
Retrieve the extension for 08123456.
Beskrivning
name: Användarnamn
email: E-post adress
extension: Användarens anknytning
Profile: Användarbeskrivning. Null om beskrivning saknas
available: Om kontakten är tillgänglig eller ej
until: Den aktuella profilens sluttid. Kommer att vara 0000-00-00 00:00:00 om ingen sluttid är definierad
message: Om kontakten har någon tilläggsinformation för hänvisning
calls: En lista över pågående samtal för anknytningen
callerid: Uppringarens ID för den andra änden
linestatus: Status för anknytningslinjen. Kan vara up/down/ringing
direction: Riktningen för samtalet. Kan vara out/in/unknown
keyWords: Lista med sökord för användaren