Oppslags-endpointet
GET https://firmatal.dk/api
Det er ett. Det returnerer ett selskap. country
er påkrevd, og nøyaktig én søkeparameter må oppgis.
Spørringsparametre
| Parameter | Påkrevd | Betydning |
|---|---|---|
| country | yes | dk or no. Which register to search. |
| vat | one of these | Registration number. 8 digits in Denmark, 9 in Norway. |
| name | one of these | Company name. Fuzzy, accent-insensitive. |
| produ | one of these | Production-unit number. |
| phone | one of these | Phone number, 8 digits. |
| ean | one of these | E-invoicing identifier (Peppol / EAN). Resolves to the registered company. |
| address | one of these | Street address. Returns the best-matching company at that address. |
| search | one of these | Any of the above. The type is detected from the value. |
| include | no | Comma-separated: owners, production_units, einvoicing. |
| format | no | json (default) or xml. |
Registreringsnumre er strenger.
En innledende null har betydning. 01234567 og
1234567 er forskjellige selskaper. Lagre aldri ett som et heltall.
Hvordan search bestemmer
Sender du search i stedet
for en navngitt parameter, blir typen utledet: et tall med registerets egen lengde er et registreringsnummer,
ti sifre i Danmark er en produksjonsenhet, åtte sifre er et telefonnummer, og alt annet er et navn.
Når du vet hva du leter etter, navngi det — utledningen er en bekvemmelighet, ikke en kontrakt.
Typede endpoints
Hver søketype er også sitt eget endpoint, som tar uttrykket som
q. Samme svar,
samme country/include/format-parametre,
men ingenting utledes noen gang — /api/name?q=12345678 søker i
navn, ikke i registreringsnumre.
GET https://firmatal.dk/api/vat?q=12345678&country=dk
GET https://firmatal.dk/api/name?q=b%C3%B8gh&country=dk
GET https://firmatal.dk/api/produ?q=1234567890&country=dk
GET https://firmatal.dk/api/phone?q=33112233&country=dk
GET https://firmatal.dk/api/ean?q=5798009811578&country=dk
GET https://firmatal.dk/api/address?q=Bredgade+12,+8000+Aarhus&country=dk