WELCOME TO THE DEVELOPERS’ SECTION
If you are curious about our API or you are a partner wishing to integrate with us, this is the place to be. Find the REST API documentation and other resources that you need to be up and running in no time.
To obtain client test certificates for accessing the test environment, please send an e-mail to email@example.com. If you have any other questions about integration, please contact firstname.lastname@example.org.
API & DOCS
HOW TO INTEGRATE WITH US
Our system offers two environments. The Test Environment, as its name implies, is intended for testing purposes. The Production Environment is where Freja eID services are available for your real users and business purposes.
Our system uses SSL/TLS certificates to verify your authenticity. There are different client certificates for the Test and Production Environments. To get them, get in touch with us at email@example.com
More information about our API, importing certificates and other details can be found in our documentation.
In the following section, you will find troubleshooting for some different scenarios you might encounter during the integration.
I AM UNABLE TO ESTABLISH THE SSL CONNECTION AGAINST FREJA eID TEST OR PRODUCTION ENVIRONMENT
Freja eID services require the SSL connection with both client and server SSL certificate verification. To establish the SSL connection, both client and server SSL certificate need to be configured in your application truststore/keystore. Contact our support to check that you have received proper client and server SSL certificates.
ERRORS IN THE FREJA eID MOBILE APPLICATION
Contact Freja eID support and provide them with the error code displayed in the Freja eID application.
THE SERVER RETURNS ERROR 404 (RESOURCE NOT FOUND)
Check the service URL you are using. The service URLs for all Freja eID services are documented in Freja eID Relying Party Developers’ Documentation under corresponding sections (refer to sections dedicated to Authentication services, Signature services or Custom identifier management respectively). If this doesn’t resolve your problem, contact Freja eID support.
THE SERVER RETURNS ERROR 422 (UNPROCESSABLE ENTITY)
This HTTP error code indicates that Freja eID back end could not process your request for some reason. Contact our support and provide them with the full HTTP response text in order for them to identify the exact reason of the request failure.
All application error codes are described in Freja eID Relying Party Developers’ Documentation (refer to sections dedicated to Authentication services, Signature services or Custom identifier management respectively).
Every few weeks we will summarize what is new, what has changed and what we fixed in Freja eID.
Our Release notes offer brief, high-level descriptions of enhancements and new features, covering changes in the API but also the user-visible changes in the Freja eID app and My Pages. We also include setup information, tips to help you get started, and best practices to ensure your continued success.
Download Release Notes November 2019 – Mobile application Android v5.3.0, iOS v5.1.0
Download Release Notes October 2019 – Mobile application Android v5.2.0, iOS v4.2.0
Download Release Notes September 2019 – Mobile application v5.1.0
Download Release Notes August 2019 – Mobile application v4.1.0
Download Release Notes August 2019 – Mobile application v4.0.0
Download Release Notes June 2019 – Mobile application v3.6.0
Download Release Notes April 2019 – Mobile applications iOS v3.3.0, Android v3.4.0
Download Release Notes March 2019 – IdP Service Update
Download Release Notes January 2019 – My Pages Update
Download Release Notes January 2019 – Mobile application v3.2.0
Download Release Notes October 2018 – Mobile application v3.0.0
Download Release Notes September 2018 – Mobile application v2.5.0
Download Release Notes August 2018 – Mobile application v2.4.0
Download Release Notes July 2018 – RP API v4.2
Download Release Notes July 2018 – Mobile application v2.3.0
Download Release Notes June 2018 – Mobile application v2.2.0
Download Release Notes June 2018 – RP API v4.1
Download Release Notes May 2018 – Mobile application v2.1.0
Download Release Notes May 2018 – Mobile application v2.0.0
Download Release Notes March 2018 – Mobile application v1.4.0, RP API v4.0