Apidocs

Webservice Documentation

Preparation

To be able to use the web service, you first need to set up a search profile. When saving the search profile, make sure that it is created with the "Web Service" option:

image

The ID of the search profile can be obtained from its URL, as shown in below example:

https://login.bindexis.ch/projects/21425/0

Important:
  • After setting up the search profile, values can be retrieved if the web service option is selected. The retrieval process will start the next day.
  • New results can only be retrieved from selected days.

Environments

url prd

https://api.login.bindexis.ch/

Login

To connect to the web service, you must first log in. This can be achieved under the endpoint POST /login_check. Refer to below example:

Example login query:
Example Login Result:

A successful access provides a JWT token and a refresh token. The former is required for any further contact with the interface. The latter is required to obtain a new token after the expiration of the current token.

Important:

A security cookie is required for concurrent access, as shown in below example.

Example:

The JWT is valid for one hour by default. If a longer session is needed, then the token can be renewed using the refresh token under POST /token/refresh as follows:

Example Refresh Query:

This query result is identical to the login query. Also, the refresh token is valid for 8 hours and is renewed with each call.

Fetching the data

Possible Endpoints

Name

all_pn_headers

projects

Brand

Ausschreibungen / Tenders

Projekte

The data retrieval process takes place via one of the above-mentioned endpoints using the GET method, for example /web_service/all_pn_headers/. Bearing this in mind, the previously obtained JWT token and the ID of the previously created search profile are required. The token is passed using the Authorization header, and the search profile ID is provided using a GET parameter as follows:

Example Data Retrieval:

If available, this query now provides the new information of your search profile. The record format can be selected by using the “Accept header” as shown below:

  • Accept: application/xml
  • Accept: application/json
  • Accept: application/ld+json

Confirmation of Pickup

The web service provides records of your search profile and remembers previous record retrieves. By default, 10 or 20 records (projects or tenders) per call are provided from the above-mentioned endpoints. Two ways are available to retrieve the next 20 records as explained below:

Confirmation via Header

If you do not want to call another endpoint, data retrieval can be confirmed by using the X-AUTO-ACK header as shown below:

Example Pickup with Auto-Ack:
Confirmation via endpoint

The next 20 records can be retrieved by using the endpoint POST /web_service/acknowledge/. Search profile ID and the IDs of confirmed records are required in the JSON object as shown below. This method minimizes the risk of losing records in the retrieval process.

Example endpoint:
Field Type Description Example
id int Eindeutige Projekt-ID 312885
title string Projekt-Titel Neubau Reservoir mit Leitungsersatz
subtitle string Projekt-Untertitel
postcode int Postleitzahl 9053
country string Land CHE
town string Stadt Teufen AR
area string Gebietsbezeichnung
street string Strassenname und Hausnummer Reservoir Häuslersegg
projectValue double Bausumme (in ganzen Währungseinheiten) 1340000
valueDescription string Bausummen Text 1.34 Mio CHF
startDate datetime Baustart 2023-05-21T22:00:00+00:00
startDateAccuracy int Wert zur Berechnung des Baustarts 12
startDescription string Baustart Text Mai 2023
endDate datetime Bauende 2024-06-29T22:00:00+00:00
endDescription string Bauende Text Juni 2024
firstPublished datetime Erstveröffentlichung 2023-01-20T10:49:16+00:00
lastPublished datetime Letzte Veröffentlichung 2023-05-23T09:13:44+00:00
lastUpdate datetime 2023-05-23T09:13:44+00:00
topProject int ID des übergeordnetem Projektes 1115
mainCategory int Hauptkategorie
externalID int Referenz-ID zu Infopro Digital Projekten 3197834
projectRolePersons
Field Type Description Example
projectRolePersonType
Field Type Description Example
id int Eindeutige ID der Personenrolle 9
code string Eindeutiger Code der Personenrolle CH_ARCHITECT
name string Name der Personenrolle Architekt
sortOrder int Sortierung 130
deprecated boolean Zeigt an, ob der Typ noch gängig ist 0
person
Field Type Description Example
id int Eindeutige ID der Person 1548945
salutationType
Field Type Description Example
id int Eindeutige ID der Anrede 33
code string Anredecode 1
name string Name der Anrede Herr
firstname string Vorname Max
lastname string Nachname Mustermann
street string Strasse Via Municipio
postcode int Postleitzahl 6850
town string Stadt Mendrisio
contactSpecifications
Field Type Description Example
content string Telefon, Fax, E-Mail, oder URL, je nach Type 071 335 00 15
contactSpecificationType
Field Type Description Example
code string Telefon PHONE
name string Telefon Telefon
projectType
Field Type Description Example
id int Eindeutige ID der Unterkategorie 33
code string Eindeutiger Code Der Unterkategorie 11
name string Name der Unterkategorie Technische Anlagen
sortOrder int Sortierreihenfolge der Unterkategorie 50
projectResearchType
Field Type Description Example
id int Eindeutige ID des Recherchetyps 8
code string Recherchetyp-Code 1
infoText string Recherchetyp
sortOrder int Sortierreihenfolge des Recherchetyps 0
purpose
Field Type Description Example
id int Eindeutige ID des Verwendungszwecks 14
code string Verwendungszweckcode CH_OWN_USE
name string Name des Verwendungszwecks Eigenbedarf
planningStage
Field Type Description Example
id int Eindeutige ID des Baustadiums 19
code string Baustadiumscode CH_PASSED_IN
name string Name des Baustadiums Baugesuch eingereicht
sortOrder int Sortierreihenfolge des Baustadiums 4
projectTexts
Field Type Description Example
content string Text Neubau Reservoir mit Leitungsersatz und Forststrasse/Zugangsweg Reservoir
projectTextType
Field Type Description Example
code string Eindeutiger Code des Text Types 1
name string Name der Textart
sortOrder int Sortierreihenfolge der Textart 1
projectDetails
Field Type Description Example
value string Wert des Details 15
negated boolean Zeigt an, ob der Wert negiert wird true
projectDetailType
Field Type Description Example
id int ID des Gebäudeausbaus 763
code string Code des Gebäudeausbaus CH_STRUCTURES
name string Name des Gebäudeausbaus Fenster
projectAttributes
Field Type Description Example
id int Eindeutige ID des Atributs 7911848
value string Wert des Attributs Gst. 1243, 2200, 848
projectAttributeType
Field Type Description Example
id int Eindeutige ID des Attributes 120
code string Eindetugier Code des Attributes 1
name string Name des Attributes
planningStageDates
Field Type Description Example
id int Eindeutige ID des Datensatzes 27447
project string URI zum Projekt /projects/312885
planningStageDate datetime Datum des Baustadiums 2023-05-23T09:13:44+00:00
planningStage
Field Type Description Example
id int Eindeutige ID des Baustadiums 19
code string Eindeutiger Code des Baustadiums CH_PASSED_IN
name string Name des Baustadiums Baugesuch eingereicht
sortOrder int Sortierreihenfolge des Baustadiums 4
projectCategories
Field Type Description Example
main boolean false
projectCategoryType
Field Type Description Example
id int Eindeutige ID der Kategorie 738
parentId int Eltern-Kategorie ID 679
code string Kategoriecode 520
name string Kategoriename Wasseraufbereitungsanlagen
projectDevelopmentType
Field Type Description Example
id int Eindeutige ID der Bauart
code string Bauartcode CH_NEW_CONSTRUCTION
name string Bauartname Neubau
sortOrder int Sortierreihenfolge der Bauart 1
deprecated boolean Zeigt an, ob der Typ noch gängig ist 0
filterable boolean Zeigt an, ob der Typ gefiltert werden kann 1
projectRoles
Field Type Description Example
active boolean Zeigt an, ob die Firma noch aktiv ist 0
mainContact boolean Zeigt an, ob es sich um den Hauptkontakt handelt 1
projectRoleType
Field Type Description Example
id int Eindeutige Rollen ID 162
code string Rollencode 1010
name string Name der Rollenbezeichnung Bauherr
teaserCompany
Field Type Description Example
id int Eindeutige Firmen ID 198123
name1 string Firmenname Max
name2 string Firmenname, Zeile 2 Mustermann GmbH
postcode string Postleitzahl 6850
town string Ort Mendrisio
company
Field Type Description Example
id int Eindeutige Firmen ID 215266
name1 string Firmenname Gemeinde Teufen
name2 string Firmenname, Zeile 2 Wasserversorgung
parishPostcode int Gemeindecode
street string Strassenname und Hausnummer Krankenhausstrasse 1
houseNo string Das Feld wird nicht verwendet -
town string Stadt Teufen AR
postcode int Postleitzahl 9053
country string Land-Code CHE
externalID int XOIS-Firmen-ID 1312979
salutationType
Field Type Description Example
id int Eindeutige ID der Anrede 33
code string Anredecode 1
name string Name der Anrede Herr
contactSpecifications
Field Type Description Example
content string Telefon, Fax, E-Mail, oder URL, je nach Type 071 335 00 15
contactSpecificationType
Field Type Description Example
code string Telefon PHONE
name string Telefon Telefon
projectRolePersons
Field Type Description Example
projectRolePersonType
Field Type Description Example
id int Eindeutige ID der Personenrolle 9
code string Eindeutiger Code der Personenrolle CH_ARCHITECT
name string Name der Personenrolle Architekt
sortOrder int Sortierung 130
deprecated boolean Zeigt an, ob der Typ noch gängig ist 0
person
Field Type Description Example
id int Eindeutige ID der Person 1548945
salutationType
Field Type Description Example
id int Eindeutige ID der Anrede 33
code string Anredecode 1
name string Name der Anrede Herr
firstname string Vorname Max
lastname string Nachname Mustermann
street string Strasse Via Municipio
postcode int Postleitzahl 6850
town string Stadt Mendrisio
contactSpecifications
Field Type Description Example
content string Telefon, Fax, E-Mail, oder URL, je nach Type 071 335 00 15
contactSpecificationType
Field Type Description Example
code string Telefon PHONE
name string Telefon Telefon
Field id
Type int
Description Eindeutige Projekt-ID
Example 312885
Field title
Type string
Description Projekt-Titel
Example Neubau Reservoir mit Leitungsersatz
Field subtitle
Type string
Description Projekt-Untertitel
Example
Field postcode
Type int
Description Postleitzahl
Example 9053
Field country
Type string
Description Land
Example CHE
Field town
Type string
Description Stadt
Example Teufen AR
Field area
Type string
Description Gebietsbezeichnung
Example
Field street
Type string
Description Strassenname und Hausnummer
Example Reservoir Häuslersegg
Field projectValue
Type double
Description Bausumme (in ganzen Währungseinheiten)
Example 1340000
Field valueDescription
Type string
Description Bausummen Text
Example 1.34 Mio CHF
Field startDate
Type datetime
Description Baustart
Example 2023-05-21T22:00:00+00:00
Field startDateAccuracy
Type int
Description Wert zur Berechnung des Baustarts
Example 12
Field startDescription
Type string
Description Baustart Text
Example Mai 2023
Field endDate
Type datetime
Description Bauende
Example 2024-06-29T22:00:00+00:00
Field endDescription
Type string
Description Bauende Text
Example Juni 2024
Field firstPublished
Type datetime
Description Erstveröffentlichung
Example 2023-01-20T10:49:16+00:00
Field lastPublished
Type datetime
Description Letzte Veröffentlichung
Example 2023-05-23T09:13:44+00:00
Field lastUpdate
Type datetime
Description
Example 2023-05-23T09:13:44+00:00
Field topProject
Type int
Description ID des übergeordnetem Projektes
Example 1115
Field mainCategory
Type int
Description Hauptkategorie
Example
Field externalID
Type int
Description Referenz-ID zu Infopro Digital Projekten
Example 3197834
Field projectRolePersons
Field projectRolePersonType
Field id
Type int
Description Eindeutige ID der Person
Example 9
Field code
Type string
Description Eindeutiger Code der Personenrolle
Example CH_ARCHITECT
Field name
Type string
Description Name der Personenrolle
Example Architekt
Field sortOrder
Type int
Description Sortierung
Example 130
Field deprecated
Type boolean
Description Zeigt an, ob der Typ noch gängig ist
Example 0
Field person
Field id
Type int
Description Eindeutige ID der Person
Example 1548945
Field salutationType
Field id
Type int
Description Eindeutige ID der Anrede
Example 33
Field code
Type string
Description Anredecode
Example 1
Field name
Type string
Description Name der Anrede
Example Herr
Field firstname
Type string
Description Vorname
Example Max
Field lastname
Type string
Description Nachname
Example Mustermann
Field street
Type string
Description Strasse
Example Via Municipio
Field postcode
Type int
Description Postleitzahl
Example 6850
Field town
Type string
Description Stadt
Example Mendrisio
Field contactSpecifications
Field content
Type string
Description Telefon, Fax, E-Mail, oder URL, je nach Type
Example 071 335 00 15
Field contactSpecificationType
Field code
Type string
Description Telefon
Example PHONE
Field name
Type string
Description Telefon
Example Telefon
Field projectType
Field id
Type int
Description Eindeutige ID der Unterkategorie
Example 33
Field code
Type string
Description Eindeutiger Code Der Unterkategorie
Example 11
Field name
Type string
Description Name der Unterkategorie
Example Technische Anlagen
Field sortOrder
Type int
Description Sortierreihenfolge der Unterkategorie
Example 50
Field projectResearchType
Field id
Type int
Description Eindeutige ID des Recherchetyps
Example 8
Field code
Type string
Description Recherchetyp-Code
Example 1
Field infoText
Type string
Description Recherchetyp
Example
Field sortOrder
Type int
Description Sortierreihenfolge des Recherchetyps
Example 0
Field purpose
Field id
Type int
Description Eindeutige ID des Verwendungszwecks
Example 14
Field code
Type string
Description Verwendungszweckcode
Example CH_OWN_USE
Field name
Type string
Description Name des Verwendungszwecks
Example Eigenbedarf
Field planningStage
Field id
Type int
Description Eindeutige ID des Baustadiums
Example 19
Field code
Type string
Description Baustadiumscode
Example CH_PASSED_IN
Field name
Type string
Description Name des Baustadiums
Example Baugesuch eingereicht
Field sortOrder
Type int
Description Sortierreihenfolge des Baustadiums
Example 4
Field projectTexts
Field content
Type string
Description Text
Example Neubau Reservoir mit Leitungsersatz und Forststrasse/Zugangsweg Reservoir
Field projectTextType
Field code
Type string
Description Eindeutiger Code des Text Types
Example 1
Field name
Type string
Description Name der Textart
Example
Field sortOrder
Type int
Description Sortierreihenfolge der Textart
Example 1
Field projectDetails
Field value
Type string
Description Wert des Details
Example 15
Field negated
Type boolean
Description Zeigt an, ob der Wert negiert wird
Example true
Field projectDetailType
Field id
Type int
Description ID des Gebäudeausbaus
Example 763
Field code
Type string
Description Code des Gebäudeausbaus
Example CH_STRUCTURES
Field name
Type string
Description Name des Gebäudeausbaus
Example Fenster
Field projectAttributes
Field id
Type int
Description Eindeutige ID des Atributs
Example 7911848
Field value
Type string
Description Wert des Attributs
Example Gst. 1243, 2200, 848
Field projectAttributeType
Field id
Type int
Description Eindeutige ID des Attributes
Example 120
Field code
Type string
Description Eindetugier Code des Attributes
Example 1
Field name
Type string
Description Name des Attributes
Example
Field planningStageDates
Field id
Type int
Description Eindeutige ID des Datensatzes
Example 27447
Field project
Type string
Description URI zum Projekt
Example /projects/312885
Field planningStageDate
Type datetime
Description Datum des Baustadiums
Example 2023-05-23T09:13:44+00:00
Field planningStage
Field id
Type int
Description Eindeutige ID des Baustadiums
Example 19
Field code
Type string
Description Eindeutiger Code des Baustadiums
Example CH_PASSED_IN
Field name
Type string
Description Name des Baustadiums
Example Baugesuch eingereicht
Field sortOrder
Type int
Description Sortierreihenfolge des Baustadiums
Example 4
Field projectCategories
Field main
Type boolean
Description
Example false
Field projectCategoryType
Field id
Type int
Description Eindeutige ID der Kategorie
Example 738
Field parentID
Type int
Description Eltern-Kategorie ID
Example 679
Field code
Type string
Description Kategoriecode
Example 520
Field name
Type string
Description Kategoriename
Example Wasseraufbereitungsanlagen
Field projectDevelopmentType
Field id
Type int
Description Eindeutige ID der Bauart
Example
Field code
Type string
Description Bauartcode
Example CH_NEW_CONSTRUCTION
Field name
Type string
Description Bauartname
Example Neubau
Field sortOrder
Type int
Description Sortierreihenfolge der Bauart
Example 1
Field deprecated
Type boolean
Description Zeigt an, ob der Typ noch gängig ist
Example 0
Field filterable
Type boolean
Description Zeigt an, ob der Typ gefiltert werden kann
Example 1
Field projectRoles
Field active
Type boolean
Description Zeigt an, ob die Firma noch aktiv ist
Example 0
Field mainContact
Type boolean
Description Zeigt an, ob es sich um den Hauptkontakt handelt
Example 1
Field projectRoleType
Field id
Type int
Description Eindeutige Rollen ID
Example 162
Field code
Type string
Description Rollencode
Example 1010
Field name
Type string
Description Name der Rollenbezeichnung
Example Bauherr
Field teaserCompany
Field id
Type int
Description Eindeutige Firmen ID
Example 198123
Field name1
Type string
Description Firmenname
Example Max
Field name2
Type string
Description Firmenname, Zeile 2
Example Mustermann GmbH
Field postcode
Type string
Description Postleitzahl
Example 6850
Field town
Type string
Description Ort
Example Mendrisio
Field company
Field id
Type int
Description Eindeutige Firmen ID
Example 215266
Field name1
Type string
Description Firmenname
Example Gemeinde Teufen
Field name2
Type string
Description Firmenname, Zeile 2
Example Wasserversorgung
Field parishPostcode
Type int
Description Gemeindecode
Example
Field street
Type string
Description Strassenname und Hausnummer
Example Krankenhausstrasse 1
Field houseNo
Type string
Description Das Feld wird nicht verwendet
Example -
Field town
Type string
Description Stadt
Example Teufen AR
Field postcode
Type int
Description Postleitzahl
Example 9053
Field country
Type string
Description Land-Code
Example CHE
Field externalID
Type int
Description XOIS-Firmen-ID
Example 1312979
Field salutationType
Field id
Type int
Description Eindeutige ID der Anrede
Example 33
Field code
Type string
Description Anredecode
Example 1
Field name
Type string
Description Name der Anrede
Example Herr
Field contactSpecifications
Field content
Type string
Description Telefon, Fax, E-Mail, oder URL, je nach Type
Example 071 335 00 15
Field contactSpecificationType
Field code
Type string
Description Telefon
Example PHONE
Field name
Type string
Description Telefon
Example Telefon
Field projectRolePersons
Field projectRolePersonType
Field id
Type int
Description Eindeutige ID der Person
Example 9
Field code
Type string
Description Eindeutiger Code der Personenrolle
Example CH_ARCHITECT
Field name
Type string
Description Name der Personenrolle
Example Architekt
Field sortOrder
Type int
Description Sortierung
Example 130
Field deprecated
Type boolean
Description Zeigt an, ob der Typ noch gängig ist
Example 0
Field person
Field id
Type int
Description Eindeutige ID der Person
Example 1548945
Field salutationType
Field id
Type int
Description Eindeutige ID der Anrede
Example 33
Field code
Type string
Description Anredecode
Example 1
Field name
Type string
Description Name der Anrede
Example Herr
Field firstname
Type string
Description Vorname
Example Max
Field lastname
Type string
Description Nachname
Example Mustermann
Field street
Type string
Description Strasse
Example Via Municipio
Field postcode
Type int
Description Postleitzahl
Example 6850
Field town
Type string
Description Stadt
Example Mendrisio
Field contactSpecifications
Field content
Type string
Description Telefon, Fax, E-Mail, oder URL, je nach Type
Example 071 335 00 15
Field contactSpecificationType
Field code
Type string
Description Telefon
Example PHONE
Field name
Type string
Description Telefon
Example Telefon