Skip to content

Introduction

Welcome to the Effi Renovation Advisor API Documentation space, powered by Überseehub! Once you have obtained a client identifier and a client secret, you can start using the API as described in the following sections. All endpoints are located at https://api.renovation-advisor.ueberseehub.de/api for production access and https://api.renovation-advisor.fa-dev-ueberseehub.de/api for testing access. Currently you only have one endpoint, POST /api/project-evaluation.

Please use the search field on the top right or find your way with the left panel navigation.

What you need to get started

To use the API you need valid credentials. Those can only be obtained by contacting us and becoming one of our partners. On how to use your credentials, please read the corresponding documentation.

  Want to use the API? Write us an email!

OpenAPI & Swagger-UI

OpenAPI is an open specification for documenting RESTful APIs. It enables developers to create a unified and machine-readable description of their APIs, including information about endpoints, request methods, data structures, authentication, and much more. OpenAPI offers developers a clear, consistent, and easily understandable way to create and manage API documentation.

Developers can use OpenAPI specifications to automatically generate client libraries or server code, speeding up development and enhancing interoperability.

Swagger-UI is part of the Swagger framework and provides an interactive interface to explore and interact with an API documentation based on OpenAPI. With Swagger-UI, developers can test and understand API endpoints without having to resort to the raw format of the specification.

The combination of OpenAPI and Swagger-UI offers developers an efficient way to utilize and understand the Renovation Advisor API. The interactive user interface of Swagger-UI significantly eases integration and development.

View SwaggerUI Download OpenAPI specification

Principles

To integrate with the effi API, we assume you to be familiar with the following technical principles:

For more information on these topics, follow the respective links. If you are unsure how to integrate with the finoOS API after reading the documentation, feel free to contact us.

Errors

Error responses of the API will return one of the HTTP error codes listed below in the Status Codes and Errors table. Error responses will contain a JSON-encoded body of the following format:

{
    "message": "Error validating request body.",
    "error": "Bad Request",
    "statusCode": 400
}

If there are multiple validation errors, the message can be an array:

{
    "message": ["projectName must be a string"],
    "error": "Bad Request",
    "statusCode": 400
}

Getting access

  Want to use the API? Write us an email!