Fiberadresse-oppslag
Denne API-endepunktet lar deg søke etter tilgjengelighet på en norsk adresse i vårt dekningskart.
URL
GET https://api.hkbb.no/address-lookup/?gatenavn=Solvang&postnr=5521
Autentisering
Bruk Authorization: Bearer <token> i header.
Forespørselsparametre
| Parameter | Beskrivelse | Eksempel | Obligatorisk |
|---|---|---|---|
| gatenavn | Deler av gatenavn | Solvang | Nei |
| husnr | Husnummer | 12 | Nei |
| postnr | Postnummer (4 siffer) | 5521 | Nei |
| poststed | Navn på sted | Haugesund | Nei |
Eksempel (cURL)
curl -X GET "https://api.hkbb.no/address-lookup/?gatenavn=Solvang&postnr=5521" \
-H "Authorization: Bearer <ditt-token>"
Eksempel på respons (JSON)
[
{
"leveransepunktid": "54321",
"leveransepunktstatus": "ActiveState",
"full_adress": "Solvang 12, 5521 Haugesund",
"gatenavn": "Solvang",
"husnr": "12",
"husbokstav": "",
"poststed": "Haugesund",
"postnr": "5521"
}
]
Feilmeldinger
{"error": "Unauthorized"}– Manglende eller ugyldig token{"message": "No match"}– Ingen treff{"message": "Too many hits. Please narrow your search."}– Over 50 treff
Forklaring: leveransepunktstatus
| Statuskode | Beskrivelse |
|---|---|
ActiveState | Tilkoblet, aktivt leveransepunkt/kunde |
ConnectedState | Tilkoblet, inaktivt leveransepunkt/kunde. Har tidligere vært kunde her. |
DisconnectedState | Nedkoblet. Installasjon med montør må til. |
ToConsideration | Ikke installert, men vi kan levere. Installasjon med montør må til. |
UnderConstruction | Ikke installert, men vi kan levere. Installasjon med montør må til. |
CancelledWork | Ikke installert, men vi kan levere. Installasjon med montør må til. |
Opprett hentekode
Dette endepunktet brukes til å opprette en hentekode og sende SMS til kunden som skal hente utstyr i butikk.
URL
POST https://api.hkbb.no/store-pickup/create/
Autentisering
Bruk Authorization: Bearer <token> i header.
Body-parametre (JSON)
| Felt | Beskrivelse | Eksempel | Obligatorisk |
|---|---|---|---|
| kundenavn | Navn på kunden | Ola Nordmann | Ja |
| kundenummer | Kundens ID | 123456 | Ja |
| mobil | Mobilnummer til kunde | 98237182 | Ja |
| partner | Navn på partner | Haugaland Kraft | Ja |
| ticket_type | Type henvendelse | stb_new_1 | Ja |
| info2butikk | Valgfri beskjed til butikk | Sendes med retur-dekoder | Nei |
Eksempel (cURL)
curl -X POST https://api.hkbb.no/store-pickup/create/ \
-H "Authorization: Bearer <ditt-token>" \
-H "Content-Type: application/json" \
-d '{
"kundenavn": "Ola Nordmann",
"kundenummer": "123456",
"mobil": "98237182",
"partner": "Haugaland Kraft",
"ticket_type": "stb_new_1",
"info2butikk": "Dekoder og fjernkontroll"
}'
Eksempel på respons (JSON)
{
"success": true,
"hentekode": "8XK2FZ",
"message": "Hentekode opprettet og SMS sendt"
}
SMS som sendes
Hei Ola Nordmann. Du kan nå gå til valgfritt Kontaktpunkt for å få hjelp.
Oversikt her: https://bit.ly/3dEItuX
Din hentekode er 8XK2FZ.
Ha en fin dag! Hilsen Haugaland Kraft
Feilmeldinger
{"error": "Unauthorized"}– Manglende eller ugyldig token{"error": "Missing required fields"}– Obligatoriske felt mangler{"error": "Database error"}– Klarte ikke lagre til databasen
Sikkerhet & logging
- Alle API-kall krever Bearer-token
- All trafikk går over HTTPS
- Alle forespørsler logges (inkludert IP og tid)
- Ved misbruk kan token og IP sperres midlertidig
Kontakt
- Teknisk kontakt: Robert Svaneland
- E-post:
robert.svaneland@hkraft.no - Telefon: +47 98 23 71 82