B2B API — Unternehmen suchen
Verwenden Sie diesen Endpunkt, um nach Unternehmen zu suchen und eine Liste der passenden Ergebnisse zu erhalten.
Zugehörige B2B-Restful-API-Dokumentation:
Nur Firmenname
Suchen Sie Unternehmen anhand ihres eingetragenen Firmennamens.
lookupcname
Anfrage
Sowohl GET als auch POST werden unterstützt.
{SERVER_ADDRESS}, {VERSION} and {LICENCE_CODE} are provided by DQE upon account creation. Contact your DQE account manager to obtain these credentials.
GEThttps://{SERVER_ADDRESS}/{VERSION}/lookupcname/?CompanyName={INPUT}&Country={COUNTRY_CODE}&Licence={LICENCE_CODE}&Filter={FILTER}
Ersetzen Sie einfach die Platzhalter in geschweiften Klammern durch Ihre Angaben.
Codebeispiele
Suche nach "dqe paris" in Frankreich
curl "https://{SERVER_ADDRESS}/{VERSION}/lookupcname/?CompanyName=dqe%20paris&Country=FRA&Licence={LICENCE_CODE}&Filter=1"
fetch("https://{SERVER_ADDRESS}/{VERSION}/lookupcname/?" + new URLSearchParams({
CompanyName: "dqe paris",
Country: "FRA",
Licence: "{LICENCE_CODE}",
Filter: "1"
}))
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.get(
"https://{SERVER_ADDRESS}/{VERSION}/lookupcname/",
params={
"CompanyName": "dqe paris",
"Country": "FRA",
"Licence": "{LICENCE_CODE}",
"Filter": "1",
},
)
print(response.json())
<?php
$params = http_build_query([
'CompanyName' => 'dqe paris',
'Country' => 'FRA',
'Licence' => '{LICENCE_CODE}',
'Filter' => '1',
]);
$ch = curl_init("https://{SERVER_ADDRESS}/{VERSION}/lookupcname/?{$params}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
const axios = require('axios');
axios.get('https://{SERVER_ADDRESS}/{VERSION}/lookupcname/', {
params: {
CompanyName: 'dqe paris',
Country: 'FRA',
Licence: '{LICENCE_CODE}',
Filter: '1'
}
})
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String url = "https://{SERVER_ADDRESS}/{VERSION}/lookupcname/"
+ "?CompanyName=dqe%20paris&Country=FRA&Licence={LICENCE_CODE}&Filter=1";
HttpAnfrage request = HttpAnfrage.newBuilder()
.uri(URI.create(url))
.GET()
.build();
HttpAntwort<String> response = client.send(request, HttpAntwort.BodyHandlers.ofString());
System.out.println(response.body());
using var client = new HttpClient();
var url = "https://{SERVER_ADDRESS}/{VERSION}/lookupcname/" +
"?CompanyName=dqe%20paris&Country=FRA&Licence={LICENCE_CODE}&Filter=1";
var response = await client.GetAsync(url);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
url := "https://{SERVER_ADDRESS}/{VERSION}/lookupcname/" +
"?CompanyName=dqe%20paris&Country=FRA&Licence={LICENCE_CODE}&Filter=1"
resp, err := http.Get(url)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
POSThttps://{SERVER_ADDRESS}/{VERSION}/lookupcname/
Fügen Sie die folgenden Parameter im Anfrage-Body im Format x-www-form-urlencoded ein.
Codebeispiele
Suche nach "dqe paris" in Frankreich
curl -X POST "https://{SERVER_ADDRESS}/{VERSION}/lookupcname/" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "Licence={LICENCE_CODE}" \
-d "CompanyName=dqe paris" \
-d "Country=FRA" \
-d "Filter=1"
fetch("https://{SERVER_ADDRESS}/{VERSION}/lookupcname/", {
method: "POST",
headers: { "Content-Type": "application/x-www-form-urlencoded" },
body: new URLSearchParams({
Licence: "{LICENCE_CODE}",
CompanyName: "dqe paris",
Country: "FRA",
Filter: "1"
})
})
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.post(
"https://{SERVER_ADDRESS}/{VERSION}/lookupcname/",
data={
"Licence": "{LICENCE_CODE}",
"CompanyName": "dqe paris",
"Country": "FRA",
"Filter": "1",
},
)
print(response.json())
<?php
$ch = curl_init("https://{SERVER_ADDRESS}/{VERSION}/lookupcname/");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
'Licence' => '{LICENCE_CODE}',
'CompanyName' => 'dqe paris',
'Country' => 'FRA',
'Filter' => '1',
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
const axios = require('axios');
const qs = require('querystring');
axios.post('https://{SERVER_ADDRESS}/{VERSION}/lookupcname/', qs.stringify({
Licence: '{LICENCE_CODE}',
CompanyName: 'dqe paris',
Country: 'FRA',
Filter: '1'
}))
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String form = "Licence={LICENCE_CODE}&CompanyName=dqe%20paris&Country=FRA&Filter=1";
HttpAnfrage request = HttpAnfrage.newBuilder()
.uri(URI.create("https://{SERVER_ADDRESS}/{VERSION}/lookupcname/"))
.header("Content-Type", "application/x-www-form-urlencoded")
.POST(HttpAnfrage.BodyPublishers.ofString(form))
.build();
HttpAntwort<String> response = client.send(request, HttpAntwort.BodyHandlers.ofString());
System.out.println(response.body());
using var client = new HttpClient();
var form = new Dictionary<string, string> {
["Licence"] = "{LICENCE_CODE}",
["CompanyName"] = "dqe paris",
["Country"] = "FRA",
["Filter"] = "1"
};
var response = await client.PostAsync(
"https://{SERVER_ADDRESS}/{VERSION}/lookupcname/",
new FormUrlEncodedContent(form));
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
form := url.Values{}
form.Set("Licence", "{LICENCE_CODE}")
form.Set("CompanyName", "dqe paris")
form.Set("Country", "FRA")
form.Set("Filter", "1")
resp, err := http.PostForm("https://{SERVER_ADDRESS}/{VERSION}/lookupcname/", form)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
Parameter
| Parameter | Beschreibung | Pflicht/Opt. |
|---|---|---|
| SERVER_ADDRESS | Adresse des DQE-Servers, der die Daten verarbeitet. | Pflicht |
| VERSION | Version der API. Beispiel: v1
|
Pflicht |
| Licence | Ihnen als Lizenzcode zugewiesene Nummer. | Pflicht |
| CompanyName | Benutzereingabe: Firmenname. | Pflicht |
| Country | ISO-3-Buchstaben-Ländercode. | Pflicht |
| Filter | Filter für den Unternehmensstatus. Mehrere Werte können durch Kommas getrennt werden. 1 — Offene, veröffentlichbare Unternehmen 2 — Geschlossene, veröffentlichbare Unternehmen 3 — Alte geschlossene, veröffentlichbare Unternehmen (über 3 Jahre) 4 — Nicht veröffentlichbare Unternehmen 5 — RNA Beispiel: Filter=1,2Optional. Standardwert:
1
|
Optional |
| NAF25 | Ob der neue Wert des Sic-Codes in Frankreich zurückgegeben werden soll: True / False Optional. Standardwert:
False
|
Optional |
API testen
Klicken Sie auf die Schaltfläche unten, um diesen Endpunkt live in Ihrem Browser zu testen.
Konsole öffnen
Nur Unternehmensnummer
Suchen Sie Unternehmen anhand ihrer Unternehmensnummer.
lookupcnum
Anfrage
Sowohl GET als auch POST werden unterstützt.
{SERVER_ADDRESS}, {VERSION} and {LICENCE_CODE} are provided by DQE upon account creation. Contact your DQE account manager to obtain these credentials.
GEThttps://{SERVER_ADDRESS}/{VERSION}/lookupcnum/?CompanyNumber={INPUT}&Country={COUNTRY_CODE}&Licence={LICENCE_CODE}&Filter={FILTER}
Ersetzen Sie einfach die Platzhalter in geschweiften Klammern durch Ihre Angaben.
Codebeispiele
Suche nach Unternehmensnummer in Frankreich
curl "https://{SERVER_ADDRESS}/{VERSION}/lookupcnum/?CompanyNumber=504xxxxxx&Country=FRA&Licence={LICENCE_CODE}&Filter=1"
fetch("https://{SERVER_ADDRESS}/{VERSION}/lookupcnum/?" + new URLSearchParams({
CompanyNumber: "504xxxxxx",
Country: "FRA",
Licence: "{LICENCE_CODE}",
Filter: "1"
}))
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.get(
"https://{SERVER_ADDRESS}/{VERSION}/lookupcnum/",
params={
"CompanyNumber": "504xxxxxx",
"Country": "FRA",
"Licence": "{LICENCE_CODE}",
"Filter": "1",
},
)
print(response.json())
<?php
$params = http_build_query([
'CompanyNumber' => '504xxxxxx',
'Country' => 'FRA',
'Licence' => '{LICENCE_CODE}',
'Filter' => '1',
]);
$ch = curl_init("https://{SERVER_ADDRESS}/{VERSION}/lookupcnum/?{$params}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
const axios = require('axios');
axios.get('https://{SERVER_ADDRESS}/{VERSION}/lookupcnum/', {
params: {
CompanyNumber: '504xxxxxx',
Country: 'FRA',
Licence: '{LICENCE_CODE}',
Filter: '1'
}
})
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String url = "https://{SERVER_ADDRESS}/{VERSION}/lookupcnum/"
+ "?CompanyNumber=504xxxxxx&Country=FRA&Licence={LICENCE_CODE}&Filter=1";
HttpAnfrage request = HttpAnfrage.newBuilder()
.uri(URI.create(url))
.GET()
.build();
HttpAntwort<String> response = client.send(request, HttpAntwort.BodyHandlers.ofString());
System.out.println(response.body());
using var client = new HttpClient();
var url = "https://{SERVER_ADDRESS}/{VERSION}/lookupcnum/" +
"?CompanyNumber=504xxxxxx&Country=FRA&Licence={LICENCE_CODE}&Filter=1";
var response = await client.GetAsync(url);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
url := "https://{SERVER_ADDRESS}/{VERSION}/lookupcnum/" +
"?CompanyNumber=504xxxxxx&Country=FRA&Licence={LICENCE_CODE}&Filter=1"
resp, err := http.Get(url)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
POSThttps://{SERVER_ADDRESS}/{VERSION}/lookupcnum/
Fügen Sie die folgenden Parameter im Anfrage-Body im Format x-www-form-urlencoded ein.
Codebeispiele
Suche nach Unternehmensnummer in Frankreich
curl -X POST "https://{SERVER_ADDRESS}/{VERSION}/lookupcnum/" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "Licence={LICENCE_CODE}" \
-d "CompanyNumber=504xxxxxx" \
-d "Country=FRA" \
-d "Filter=1"
fetch("https://{SERVER_ADDRESS}/{VERSION}/lookupcnum/", {
method: "POST",
headers: { "Content-Type": "application/x-www-form-urlencoded" },
body: new URLSearchParams({
Licence: "{LICENCE_CODE}",
CompanyNumber: "504xxxxxx",
Country: "FRA",
Filter: "1"
})
})
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.post(
"https://{SERVER_ADDRESS}/{VERSION}/lookupcnum/",
data={
"Licence": "{LICENCE_CODE}",
"CompanyNumber": "504xxxxxx",
"Country": "FRA",
"Filter": "1",
},
)
print(response.json())
<?php
$ch = curl_init("https://{SERVER_ADDRESS}/{VERSION}/lookupcnum/");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
'Licence' => '{LICENCE_CODE}',
'CompanyNumber' => '504xxxxxx',
'Country' => 'FRA',
'Filter' => '1',
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
const axios = require('axios');
const qs = require('querystring');
axios.post('https://{SERVER_ADDRESS}/{VERSION}/lookupcnum/', qs.stringify({
Licence: '{LICENCE_CODE}',
CompanyNumber: '504xxxxxx',
Country: 'FRA',
Filter: '1'
}))
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String form = "Licence={LICENCE_CODE}&CompanyNumber=504xxxxxx&Country=FRA&Filter=1";
HttpAnfrage request = HttpAnfrage.newBuilder()
.uri(URI.create("https://{SERVER_ADDRESS}/{VERSION}/lookupcnum/"))
.header("Content-Type", "application/x-www-form-urlencoded")
.POST(HttpAnfrage.BodyPublishers.ofString(form))
.build();
HttpAntwort<String> response = client.send(request, HttpAntwort.BodyHandlers.ofString());
System.out.println(response.body());
using var client = new HttpClient();
var form = new Dictionary<string, string> {
["Licence"] = "{LICENCE_CODE}",
["CompanyNumber"] = "504xxxxxx",
["Country"] = "FRA",
["Filter"] = "1"
};
var response = await client.PostAsync(
"https://{SERVER_ADDRESS}/{VERSION}/lookupcnum/",
new FormUrlEncodedContent(form));
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
form := url.Values{}
form.Set("Licence", "{LICENCE_CODE}")
form.Set("CompanyNumber", "504xxxxxx")
form.Set("Country", "FRA")
form.Set("Filter", "1")
resp, err := http.PostForm("https://{SERVER_ADDRESS}/{VERSION}/lookupcnum/", form)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
Parameter
| Parameter | Beschreibung | Pflicht/Opt. |
|---|---|---|
| SERVER_ADDRESS | Adresse des DQE-Servers, der die Daten verarbeitet. | Pflicht |
| VERSION | Version der API. Beispiel: v1
|
Pflicht |
| Licence | Ihnen als Lizenzcode zugewiesene Nummer. | Pflicht |
| CompanyNumber | Benutzereingabe: Unternehmensnummer. | Pflicht |
| Country | ISO-3-Buchstaben-Ländercode. | Pflicht |
| Filter | Filter für den Unternehmensstatus. Mehrere Werte können durch Kommas getrennt werden. 1 — Offene, veröffentlichbare Unternehmen 2 — Geschlossene, veröffentlichbare Unternehmen 3 — Alte geschlossene, veröffentlichbare Unternehmen (über 3 Jahre) 4 — Nicht veröffentlichbare Unternehmen 5 — RNA Beispiel: Filter=1,2Optional. Standardwert:
1
|
Optional |
| NAF25 | Ob der neue Wert des Sic-Codes in Frankreich zurückgegeben werden soll: True / False Optional. Standardwert:
False
|
Optional |
API testen
Klicken Sie auf die Schaltfläche unten, um diesen Endpunkt live in Ihrem Browser zu testen.
Konsole öffnen
Firmenname und Postleitzahl
Suchen Sie Unternehmen anhand ihres Namens in Kombination mit einer Postleitzahl, für ein präziseres Ergebnis.
checkcname
Anfrage
Sowohl GET als auch POST werden unterstützt.
{SERVER_ADDRESS} and {LICENCE_CODE} are provided by DQE upon account creation. Contact your DQE account manager to obtain these credentials.
Versionsspezifisch: Dieser Vorgang ist nur in API-Version
v1 verfügbar — nicht in v2. Verwenden Sie für diesen Vorgang ausschließlich v1 in der URL, auch wenn andere B2B-Restful-Vorgänge beide Versionen unterstützen. GEThttps://{SERVER_ADDRESS}/v1/checkcname/?CompanyName={INPUT}&Country={COUNTRY_CODE}&PostalCode={POSTALCODE}&Licence={LICENCE_CODE}&Filter={FILTER}
Ersetzen Sie einfach die Platzhalter in geschweiften Klammern durch Ihre Angaben.
Codebeispiele
Suche nach "dqe paris" in der Nähe der Postleitzahl 75017
curl "https://{SERVER_ADDRESS}/v1/checkcname/?CompanyName=dqe%20paris&Country=FRA&PostalCode=75017&Licence={LICENCE_CODE}&Filter=1"
fetch("https://{SERVER_ADDRESS}/v1/checkcname/?" + new URLSearchParams({
CompanyName: "dqe paris",
Country: "FRA",
PostalCode: "75017",
Licence: "{LICENCE_CODE}",
Filter: "1"
}))
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.get(
"https://{SERVER_ADDRESS}/v1/checkcname/",
params={
"CompanyName": "dqe paris",
"Country": "FRA",
"PostalCode": "75017",
"Licence": "{LICENCE_CODE}",
"Filter": "1",
},
)
print(response.json())
<?php
$params = http_build_query([
'CompanyName' => 'dqe paris',
'Country' => 'FRA',
'PostalCode' => '75017',
'Licence' => '{LICENCE_CODE}',
'Filter' => '1',
]);
$ch = curl_init("https://{SERVER_ADDRESS}/v1/checkcname/?{$params}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
const axios = require('axios');
axios.get('https://{SERVER_ADDRESS}/v1/checkcname/', {
params: {
CompanyName: 'dqe paris',
Country: 'FRA',
PostalCode: '75017',
Licence: '{LICENCE_CODE}',
Filter: '1'
}
})
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String url = "https://{SERVER_ADDRESS}/v1/checkcname/"
+ "?CompanyName=dqe%20paris&Country=FRA&PostalCode=75017&Licence={LICENCE_CODE}&Filter=1";
HttpAnfrage request = HttpAnfrage.newBuilder()
.uri(URI.create(url))
.GET()
.build();
HttpAntwort<String> response = client.send(request, HttpAntwort.BodyHandlers.ofString());
System.out.println(response.body());
using var client = new HttpClient();
var url = "https://{SERVER_ADDRESS}/v1/checkcname/" +
"?CompanyName=dqe%20paris&Country=FRA&PostalCode=75017&Licence={LICENCE_CODE}&Filter=1";
var response = await client.GetAsync(url);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
url := "https://{SERVER_ADDRESS}/v1/checkcname/" +
"?CompanyName=dqe%20paris&Country=FRA&PostalCode=75017&Licence={LICENCE_CODE}&Filter=1"
resp, err := http.Get(url)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
POSThttps://{SERVER_ADDRESS}/v1/checkcname/
Fügen Sie die folgenden Parameter im Anfrage-Body im Format x-www-form-urlencoded ein.
Codebeispiele
Suche nach "dqe paris" in der Nähe der Postleitzahl 75017
curl -X POST "https://{SERVER_ADDRESS}/v1/checkcname/" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "Licence={LICENCE_CODE}" \
-d "CompanyName=dqe paris" \
-d "PostalCode=75017" \
-d "Country=FRA" \
-d "Filter=1"
fetch("https://{SERVER_ADDRESS}/v1/checkcname/", {
method: "POST",
headers: { "Content-Type": "application/x-www-form-urlencoded" },
body: new URLSearchParams({
Licence: "{LICENCE_CODE}",
CompanyName: "dqe paris",
PostalCode: "75017",
Country: "FRA",
Filter: "1"
})
})
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.post(
"https://{SERVER_ADDRESS}/v1/checkcname/",
data={
"Licence": "{LICENCE_CODE}",
"CompanyName": "dqe paris",
"PostalCode": "75017",
"Country": "FRA",
"Filter": "1",
},
)
print(response.json())
<?php
$ch = curl_init("https://{SERVER_ADDRESS}/v1/checkcname/");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
'Licence' => '{LICENCE_CODE}',
'CompanyName' => 'dqe paris',
'PostalCode' => '75017',
'Country' => 'FRA',
'Filter' => '1',
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
const axios = require('axios');
const qs = require('querystring');
axios.post('https://{SERVER_ADDRESS}/v1/checkcname/', qs.stringify({
Licence: '{LICENCE_CODE}',
CompanyName: 'dqe paris',
PostalCode: '75017',
Country: 'FRA',
Filter: '1'
}))
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String form = "Licence={LICENCE_CODE}&CompanyName=dqe%20paris&PostalCode=75017&Country=FRA&Filter=1";
HttpAnfrage request = HttpAnfrage.newBuilder()
.uri(URI.create("https://{SERVER_ADDRESS}/v1/checkcname/"))
.header("Content-Type", "application/x-www-form-urlencoded")
.POST(HttpAnfrage.BodyPublishers.ofString(form))
.build();
HttpAntwort<String> response = client.send(request, HttpAntwort.BodyHandlers.ofString());
System.out.println(response.body());
using var client = new HttpClient();
var form = new Dictionary<string, string> {
["Licence"] = "{LICENCE_CODE}",
["CompanyName"] = "dqe paris",
["PostalCode"] = "75017",
["Country"] = "FRA",
["Filter"] = "1"
};
var response = await client.PostAsync(
"https://{SERVER_ADDRESS}/v1/checkcname/",
new FormUrlEncodedContent(form));
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
form := url.Values{}
form.Set("Licence", "{LICENCE_CODE}")
form.Set("CompanyName", "dqe paris")
form.Set("PostalCode", "75017")
form.Set("Country", "FRA")
form.Set("Filter", "1")
resp, err := http.PostForm("https://{SERVER_ADDRESS}/v1/checkcname/", form)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
Parameter
| Parameter | Beschreibung | Pflicht/Opt. |
|---|---|---|
| SERVER_ADDRESS | Adresse des DQE-Servers, der die Daten verarbeitet. | Pflicht |
| VERSION | Für diesen Vorgang fest auf v1 festgelegt — nicht konfigurierbar, v2 unterstützt dies nicht. |
Pflicht |
| Licence | Ihnen als Lizenzcode zugewiesene Nummer. | Pflicht |
| CompanyName | Benutzereingabe: Firmenname. | Pflicht |
| PostalCode | Postleitzahl. | Pflicht |
| Country | ISO-3-Buchstaben-Ländercode. | Pflicht |
| Filter | Filter für den Unternehmensstatus. Mehrere Werte können durch Kommas getrennt werden. 1 — Offene, veröffentlichbare Unternehmen 2 — Geschlossene, veröffentlichbare Unternehmen 3 — Alte geschlossene, veröffentlichbare Unternehmen (über 3 Jahre) 4 — Nicht veröffentlichbare Unternehmen 5 — RNA Beispiel: Filter=1,2Optional. Standardwert:
1
|
Optional |
| NAF25 | Ob der neue Wert des Sic-Codes in Frankreich zurückgegeben werden soll: True / False Optional. Standardwert:
False
|
Optional |
API testen
Klicken Sie auf die Schaltfläche unten, um diesen Endpunkt live in Ihrem Browser zu testen.
Konsole öffnen
Antwort
Diese Antwortstruktur wird von allen drei oben genannten Anfragemodi gemeinsam genutzt (lookupcname, lookupcnum und checkcname).
Die JSON-Antwort ist ein Dictionary (Objekt), das zwei Hauptschlüssel enthält:
- Found: Ganzzahl, die die Anzahl der gefundenen Unternehmen angibt.
- Companies: Liste mit einem oder mehreren Unternehmensobjekten.
Jedes Unternehmensobjekt enthält die folgenden Schlüssel:
| Schlüssel | Beschreibung | Typ/Einschränkungen |
|---|---|---|
| City | Stadt, in der sich das Unternehmen befindet. | String, up to 100 characters |
| L1Standardized | Standardisierte Adresszeile 1, häufig der eingetragene Name. | String, up to 255 characters |
| MainCompanyFlag | Gibt an, ob es sich um den Hauptunternehmensdatensatz handelt. 1: ja; 0: nein. |
String or integer |
| CompanyStatus | Verwaltungsstatus des Unternehmens. 0: aktiv. |
String or integer |
| VatNumber | Innergemeinschaftliche USt-IdNr. Dieses Feld ist leer, wenn das Unternehmen nicht umsatzsteuerpflichtig ist. |
String |
| SearchRef | Interne Referenz, die das Ergebnis mit der Suchanfrage verknüpft. | String |
| PhoneNumber | Telefonnummer des Unternehmens. | String |
| LegalStructure | Rechtsform des Unternehmens. | Array of objects: { Value, Label }
|
| L2Standardized | Standardisierte Adresszeile 2. | String |
| CompanyNumber | Satz rechtlicher Kennungen, wie SIREN und NIC. | Array of objects: { Type, Value }
|
| CompanyCName | Handelsname oder vollständiger Firmenname. | String |
| IncorporationDate | Datum der Unternehmensgründung. | String, YYYY-MM-DD
|
| StaffCount | Angegebene Mitarbeiterzahl oder -spanne. | String |
| Classification | Klassifizierungscodes der Geschäftstätigkeit. | Array of objects: { Type, Value, Label }
|
| L5Standardized | Standardisierte Adresszeile 5. | String |
| DissolutionDate | Datum, an dem das Unternehmen aufgelöst wurde, falls zutreffend. | String, YYYY-MM-DD
|
| L4Standardized | Standardisierte Adresszeile mit Straße und Hausnummer. | String |
| PosCod | Postleitzahl. | String, up to 10 characters |
| TurnOver | Gemeldeter Umsatz. | String or number |
Antwortbeispiel
Beispiel: "DQE SOFTWARE" in Paris
{
"Found": 1,
"Companies": [
{
"City": "PARIS",
"L1Standardized": "DQE-SOFTWARE",
"MainCompanyFlag": "0",
"CompanyStatus": "0",
"VatNumber": "FR 85 504403387",
"SearchRef": "_33170132",
"PhoneNumber": "",
"LegalStructure": [
{
"Value": "5710",
"Label": "SAS, société par actions simplifiée"
}
],
"L2Standardized": "",
"CompanyNumber": [
{
"Type": "Siren",
"Value": "504xxxxxx"
},
{
"Type": "Nic",
"Value": "xxxxx"
}
],
"CompanyCName": "DQE SOFTWARE",
"IncorporationDate": "2014-11-17",
"StaffCount": "Non-employer",
"Classification": [
{
"Type": "NAF08",
"Value": "5829C",
"Label": "Edition de logiciels applicatifs"
}
],
"L5Standardized": "",
"DissolutionDate": "2018-01-31",
"L4Standardized": "42 RUE FORTUNY",
"PosCod": "75017",
"TurnOver": ""
}
]
}
Fehler
Diese Fehler gelten für alle drei oben genannten Anfragemodi — die API ordnet Fehler dem fehlenden oder ungültigen Parameternamen zu, nicht dem Endpunkt.
| HTTP | Fehlertyp | Antwort-Body |
|---|---|---|
| 400 | Fehlender Parameter Licence
|
{"status": 400, "message": "Missing parameters", "details": "Licence", "error": "bad request"} |
| 400 | Leerer Parameter Licence
|
{"status": 400, "message": "Missing parameters", "details": "Licence", "error": "bad request"} |
| 401 | Falsche Lizenznummer | {"status": 401, "message": "Your licence is not allowed to cover this functionnality", "details": "{WRONG LICENSE}", "error": "unauthorized_client"} |
| 400 | Fehlender Parameter CompanyName (oder CompanyNumber/PostalCode, je nach verwendetem Modus) |
{"status": 400, "message": "Missing parameters", "details": "CompanyName", "error": "bad request"} |
| 400 | Fehlender Parameter Country
|
{"status": 400, "message": "Missing parameters", "details": "Country", "error": "bad request"} |
| 400 | Leerer Parameter CompanyName
|
{"status": 400, "message": "Missing parameters", "details": "CompanyName", "error": "bad request"} |
| 200 | Leerer Parameter Country — wird nicht als Fehler behandelt, liefert ein leeres Ergebnis |
{"Found":0,"Companies":[]} |
Siehe auch
Verknüpfung mit