API Reference
The main Web API end points required for most host integrations.
The below documentation is created programmatically using the Keyfax Web API OpenAPI specification. For more detailed examples on how to call each of these API end-points please see our Web API Quick Start and Deep Dive guides.
Obtaining a Keyfax Launch URL
Use these end-points to post start-up data and obtain a Keyfax launch URL.
This method returns example start-up data. You can POST the returned example start-up data to this same end point to generate launch data for Keyfax. It's important to remember you will likely need to customize the example start-up data to correctly work within your environment. The example data is only provided for convenience.
A valid bearer authorization schema. For example "Bearer {hostName}:{jsonWebToken}". Please refer to Keyfax Web API documentation for assistance or use the Keyfax Web API .NET or JavaScript SDK.
GET /interview/api/v1/startup HTTP/1.1
Host: localhost:8088
Accept: */*
{
"startUpXml": "text",
"originatingSystem": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"guid": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"originatingGuid": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"mode": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"userName": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"password": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"company": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"clientId": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"scriptSet": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"category": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"topic": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"returnUrl": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"callerDetails": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"tenantId": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"tenant": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"tenancy": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"tenancyDetails": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"assetId": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"asset": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"propertyId": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"property": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"repairNo": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"rolDetail": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"customData": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
}
This method accepts start-up data to instantiate a Keyfax session. The start-up data can be posted within the request body and can be represented as either JSON or XML. Use this end points GET method to obtain example start-up data you can POST to this method.
A valid bearer authorization schema. For example "Bearer {hostName}:{jsonWebToken}". Please refer to Keyfax Web API documentation for assistance or use the Keyfax Web API .NET or JavaScript SDK.
POST /interview/api/v1/startup HTTP/1.1
Host: localhost:8088
Content-Type: application/json
Accept: */*
Content-Length: 11724
{
"startUpXml": "text",
"originatingSystem": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"guid": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"originatingGuid": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"mode": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"userName": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"password": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"company": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"clientId": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"scriptSet": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"category": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"topic": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"returnUrl": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"callerDetails": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"tenantId": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"tenant": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"tenancy": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"tenancyDetails": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"assetId": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"asset": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"propertyId": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"property": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"repairNo": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"rolDetail": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
},
"customData": {
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
],
"children": [
{
"key": "text",
"id": "text",
"value": "text",
"attributes": "[Circular Reference]",
"children": "[Circular Reference]"
}
]
}
}
{
"guid": "text",
"launchUrl": "text",
"company": "text"
}
Processing Keyfax Results
Use this end point to obtain Keyfax results.
Returns script results for a given session. Results are only available after a Keyfax session has been started and the session has been completed or canceled.
A valid bearer authorization schema. For example "Bearer {hostName}:{jsonWebToken}". Please refer to Keyfax Web API documentation for assistance or use the Keyfax Web API .NET or JavaScript SDK.
POST /interview/api/v1/results HTTP/1.1
Host: localhost:8088
Content-Type: application/json
Accept: */*
Content-Length: 51
{
"guid": "text",
"launchUrl": "text",
"company": "text"
}
{}
Obtaining API keys
Use these end-points to generate API keys for our Basic
or API Key
verification methods.
This end point can be accessed anonymously without authentication and is intended to generate initial keys for use with the Keyfax Web API. The initial key will only be returned via this end point if no existing Web API keys exist for the supplied host name. The supplied host name must also first be defined via the WebApi/KeyGen element within kfServerConfig.xml before keys can be generated. If existing keys exist this end point will return a 400 Bad Request response. To generate additional keys you can use the initial keys and perform a POST request to this same end point to generate additional Web API keys.
The name of the host to create the keys for - i.e. DEV, LIVE, TEST etc. To ensure new keys can be sent correctly ensure the kfServerConfig.xml file contains a WebApi/KeyGen element with a matching host name attribute.
GET /interview/api/v1/key HTTP/1.1
Host: localhost:8088
Accept: */*
{
"apiKey": "text",
"signingKey": "text",
"schemaName": "text",
"hostName": "text",
"message": "text"
}
If you believe your Keyfax Web API keys have been compromised you can call this end point to generate new API keys within Keyfax. An authenticated POST request to this end point will generate new API keys within Keyfax. This end point will only return the new API key. The new signing key will be sent along with the new API key to the white-listed delivery mechanism defined within your Keyfax KfServerConfig.xml file. If a web hook URL is defined within configuration the new keys will be posted as a {Keyfax.WebApi.Sdk.Basic.v1.Models.KeyResult} JSON object to the defined web hook URL. If an email address is defined the signing key will be sent to the defined email address. If both a web hook URL and email address are defined the signing key will be posted to the defined web hook URL and also sent to the defined email address. The web hook URL and / or email address delivery mechanisms are defined via the WebApi/KeyGen element within your Keyfax KfServerConfig.xml file.
A valid basic authorization schema. For example "Basic {hostName}:{apiKey}:{requestSignature}:{nonce}:{timeStamp}". Please refer to Keyfax Web API documentation for assistance or use the Keyfax Web API .NET or JavaScript SDK.
POST /interview/api/v1/key HTTP/1.1
Host: localhost:8088
Authorization: text
Accept: */*
{
"apiKey": "text",
"signingKey": "text",
"schemaName": "text",
"hostName": "text",
"message": "text"
}
The name of the host to delete the keys for - i.e. DEV, LIVE, TEST etc. To ensure new keys can be deleted ensure the kfServerConfig.xml file contains a WebApi/KeyGen element with a matching host name attribute.
A valid basic authorization schema. For example "Basic {hostName}:{apiKey}:{requestSignature}:{nonce}:{timeStamp}". Please refer to Keyfax Web API documentation for assistance or use the Keyfax Web API .NET or JavaScript SDK.
DELETE /interview/api/v1/key HTTP/1.1
Host: localhost:8088
Authorization: text
Accept: */*
{}
Bearer / JWT Tokens
Use these end-points to obtain a short-lived JSON Web Token (JWT) for Bearer
verification.
The generated JSON Web Token is signed using your Keyfax private API key and contains your public API key as a claim to further verify requests. This method can only be called using "Basic" authentication as this method is typically called from server side code were you can secure your Keyfax Web API signing key. The generated JSON Web Token will be valid for 24 hours after creation by default. For long running sessions you should use the JSON Web Token generated by this GET method to periodically call POST /api/v1/token to renew or generate additional JSON Web Tokens for long running client sessions.
A valid basic authorization schema. For example "Basic {hostName}:{apiKey}:{requestSignature}:{nonce}:{timeStamp}". Please refer to Keyfax Web API documentation for assistance or use the Keyfax Web API .NET or JavaScript SDK.
GET /interview/api/v1/token HTTP/1.1
Host: localhost:8088
Authorization: text
Accept: */*
{
"company": "text",
"token": "text"
}
Renews a JSON Web Token / JWT for client side authentication purposes given an existing valid JWT.
Requires an existing valid JSON Web Token for authentication purposes. If authentication is successful this end point will generate a new JSON Web Token which will expire again within 24 hours. The resulting JWT is derived from the current active API & signing keys used for server side basic authentication. To obtain a JWT for the first time you must make a GET request to /api/v1/token using server side authentication supplying a valid basic authorization header. Once the server has issued an initial JWT this can then be used on clients for subsequent API requests or to periodically renew the JWT for long running sessions using this end point.
A valid bearer authorization schema. For example "Bearer {hostName}:{jsonWebToken}". Please refer to Keyfax Web API documentation for assistance or use the Keyfax Web API .NET or JavaScript SDK.
POST /interview/api/v1/token HTTP/1.1
Host: localhost:8088
Authorization: text
Accept: */*
{
"company": "text",
"token": "text"
}
Last updated