Postnummervalidering

Fraktguiden tilbyr en egen tjeneste for validering av postnummer. Denne tjenesten kan enten brukes som en back-end løsning for å kontrollere brukerinput, eller den kan benyttes i ulike grensesnitt for å forenkle informasjonen som oppgis av brukeren.

Fraktguiden tilbyr postnummervalidering i tre dataformater (klikk for å se eksempel):

• XML
• JSONP
• HTML

Tjenesten benyttes ved å etterspørre det relevante formatet med parameteren pnr=7600, der 7600 erstattes med et vilkårlig postnummer.

XML

Tjenesten for postnummervalidering som XML leverer poststedet tilbake i et XML <Response>-element. Elementet har attributten valid="true" og poststedet som verdi dersom postnummeret er gydlig, eller attributten valid="false" og strengen "Ugyldig postnummer" som verdi dersom postnummeret er ugyldig.

JSONP

JSONP (JavaScript Object Notation with Padding) er egnet for å dynamisk oppdatere et webgrensesnitt slik at poststedet kommer opp automatisk når brukeren skriver inn postnummeret sitt.

Boksen under viser et eksempel på hvordan JSONP kan brukes til å automatisk sette poststed for et oppgitt postnummer (fyll inn postnummer - fire siffer - for å få opp poststed):

Denne snutten benytter seg av JQuery. Koden for denne boksen er:

<script src="http://code.jquery.com/jquery-latest.js"></script>

<script type="text/javascript">
   $(document).ready(function() {
      inputField = $('#postnummerInput');
      outputElement = $('#postnummerResult');
      
      inputField.keyup(function() {
         if (inputField.val().length == 4) {
            $.getJSON('http://fraktguide.bring.no/fraktguide/postalCode.json?pnr='+ inputField.val() +'&callback=?',
            function(data){
               outputElement.text(data.result);
            });
         }
         else {
            outputElement.text('');
         }
      });
   });
</script>
<form>
   <input type="text" id="postnummerInput" style="width: 4em;"/>  <span id="postnummerResult"> </span>
</form>

HTML

Denne oppslagsmåten benyttes internt på fraktguide-sidene, men er ikke veldig egnet til oppslag fra eksterne sider grunnet browserbegrensninger på ajax kall på tvers av domener. Hvis det skal benyttes fra eksterne sider må oppslaget gjøres i en IFRAME (endre iframens "src" attributt for å gjøre oppslag).

Generelt leverer HTML-tjenesten poststedet i en html <span>. Dette elementet kan stilsettes som ønsket ved hjelp av CSS. Dersom postnummeret som etterspørres er ugyldig returneres teksten "Ugyldig postnummer" og elementet har class attributt lik "bringPostnumberQueryInvalidPostnumber".