Skip to main content

Use Cases

The following page contains common question and use cases description.

Not Able to Receive Callbacks

By default, when creating conversation you can provide the callbackUrl, which is the URL that will be used to send you the result of conversation. We know that receiving traffic from the outside world is not always possible and that's why we provide the option to manually check the conversation status.

Though possible we strongly advice against periodic manual status check of the conversation status. Depending on the product that you are using the time between the conversation creation and the results being available may be long - for example when your conversation depend on manual verification by the provider. You need to keep that in mind.We try to help our users as much as we can, but in extreme cases of the API abuse we may cut off the access to the discussed API.

Regardless of that, if you need to check conversation status (for example during test, for debug purposes) you can ask about its condition at any time, using the method below.

Remember to adapt the conversation id in the address to your case:

curl -u my_login "https://sandbox.authologic.com/api/conversations/c12c1adc-3ff0-4d32-b95c-c593135c903e" \
-H "Accept: application/vnd.authologic.v1.1+json" \
-H "Content-Type: application/vnd.authologic.v1.1+json"

Of course, instead of my_login enter your login. You should be prompted for a password - at that point you should enter the API key (do not confuse it with the password to the customer panel).

Assuming that you have finished the process, you should expect following response:

{
  "id": "c12c1adc-3ff0-4d32-b95c-c593135c903e",
  "userKey": "7dfb9ded-c38f-49ae-95e2-307283a0b1f6",
  "url": "https://sandbox.authologic.com/c/c12c1adc-3ff0-4d32-b95c-c593135c903e",
  "status": "FINISHED",
  "result": {
    "identity": {
      "status": "FINISHED",
      "errors": [],
      "user": {
        "person": {
          "name": {
            "firstName": "Jan",
            "lastName": "Testowy"
          }
        }
      }
    }
  }
}
Despite our sincere intentions, it is difficult to create perfect technical documentation. If you have an idea on how to improve this documentation, or you have trouble understanding any section, please email us at tech-support@authologic.com
Was this page helpful?
Powered by Authologic Nisaba