Menu
Quick manual

How to use the ticket API and content API's

This quick manual will help you understand how the ticket API and the content REST API’s works. Please, start with step 1 and proceed then to step 2.

1) The ticket API (authentication)

The ticket API will do a simple HTTP Basic authentication. If the authentication is successful, then the API will return http status code 200 and valid ticket value in the JSON format. If the authentication fails, then it will return http status code 401 and error message in the JSON format. In order to use the ticket API, you must have a valid user account (username and password) on production and test environments.

The ticket API endpoints

· https://api.bisnode.fi/permission/v1/ticket - production environment
· https://api-test.bisnode.fi/permission/v1/ticket - test environment

Successful request (http status code 200)

Failed request (http status code 401)

2) The person basic information API

The API returns the person's basic information in JSON format, as specified by Bisnode ID or person identification number. The ticket parameter (please, check step 1 how to get a valid ticket) must be sent in the API's request custom header element. If the ticket value is valid then the API request will be successful (http status code 200), otherwise it will fail (http status code 401).

Successful request (http status code 200)

Failed request (http status code 401)


FAQ

How to use the ticket?

The ticket parameter must be sent in the request custom header element. If the ticket value is valid then API request will be successful (http status code 200), otherwise it will fail (http status code 401).

How long does a ticket last?

A ticket is valid for 20 minutes, after that it will automatically expire.

How to get a new valid ticket?

Ticket API returns a new valid ticket.

Tulosta

Läs mer om våra tjänster på www.bisnode.com Bisnode