Bring Fraktguide: Prøv tjenesten: JSONP (beta)

Prøv tjenesten: JSON (beta)

JSON er en teknologi som gjør det enda enklere å ta i bruk data fra Bring; den er enklere enn både Web Service og XML API. JSON er spesielt godt egnet til bruk rett i nettleser; Kopier inn HTML på en side og du er i gang! Ingen utvikling på server er nødvendig.

JSON (JavaScript Object Notation) er et lettvektsformat for å utveksle data som er lette å ta i bruk i JavaScript som kjører i en nettleser. Utvidelsen JSONP gjør om datastrukturen til en funksjon slik at du fra din nettside kan inkludere data fra Fraktguiden dynamisk og uten å gå via din egen server.

Tjenesten er gratis tilgjengelig forutsatt aksept av bruksvilkårene. Merk at kun registerte brukere vil få meldinger om endringer i tjenesten! Dersom du benytter prisinformasjon fra klientkode i nettleseren anbefaler vi på det sterkeste at du sjekker dette på serveren (med f.eks. XML API) for å unngå misbruk av din tjeneste.

Enkel demo - fyll inn ditt postnummer!

Dersom du sender en Servicepakke på 3 kilo
fra Oslo til postnummer vil...

Hvordan få inn demo på din nettside

Alt du trenger å gjøre for å ha lignende funksjonalitet på din nettside er å lime inn en HTML og JavaScript snutt på din nettside. Tilpass funksjonalitet og tekst til ditt behov.

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

<script type="text/javascript">
 $(document).ready(function() {
  inputField = $('#postnummer');
  outputElement = $('#textResult');
  inputField.keyup(function() {
   if (inputField.val().length > 3) {
    $.getJSON('http://fraktguide.bring.no/fraktguide/products/SERVICEPAKKE/all.json?from=0150&to='+ inputField.val() +'&weightInGrams=3&date=2010-09-10&callback=?',
  	     function(data){
	      outputElement.html('<ul><li>...det koste ' + data.Product.Price.PackagePriceWithoutAdditionalServices.AmountWithVAT + ' + mva.</li>' +
	       ' <li>...transporttid være ' + data.Product.ExpectedDelivery.WorkingDays + ' virkedag(er). </li>' + 
	       ' <li>...pakken være hos mottaker den ' + data.Product.ExpectedDelivery.FormattedExpectedDeliveryDate + ' dersom pakken er levert på terminal innenfor fristen i dag.</li>' + 
	       ' <li>...informasjon om utlevering: ' + data.Product.GuiInformation.DescriptionText + '</li></ul>');
	     });
   } else {
    outputElement.html('');
   }
  });
 });
</script>

<p>
  Dersom du sender en Servicepakke på 3 kilo <br/>fra Oslo til postnummer <input type="text" id="postnummer" style="width: 3em;" maxlength="4"/> vil... <br/><span id="textResult"></span>
</p>

Spørring og returdata

Strukturen i requestparametere og returdata er identisk med XML API, bortsett fra følgende

Toppnivå wrapperelementet "Package" i JSON returdata er implisitt (har ikke egen wrapper node)
Når det ikke spørres spesifikt om ett produkt, så returneres produktdata i et produktarray (firkant-klammer rundt produktene)
Når det spørres kun om ett spesifikt produkt, så returneres produktdata i et produktelement
Det støttes en callback parameter (f.eks callback=myFunction) for bruk av JSONP (ajax kall på tvers av domener).

Benytt dokumentasjonen til XML API for detaljer på parametere og funksjonalitet.

Eksempler på bruk

Ønsket format	Beskrivelse	Ett produkt	Alle produkter
JSON	Se på XML API, bytt ut extension med .json	json	json
JSONP	Samme som JSON. Legg på parameteren "callback=[navn på funksjon]".	json	json

Merk forskjellen i de to kolonnene over at produkter i det siste tilfellet ligger i en array.

Ressurser

JSON kan benytte forskjellige ressurser i Fraktguiden for å hente ut akkurat det du trenger.

Valg av ressurs det spørres etter gjøres på følgende måte:

Transporttid (json)
Pris (json)
Pris, forsendelsestid og produkttekster (json)

Begrensningen av produkt gjøres på følgende måte:

Videoer

Produktark (pdf)

Innlogging

Forum og tilbakemelding

Teamet bruker egen løsning for brukerstøtte, ønsker og tilbakemeldinger. Gå til forum

Kontakt teamet direkte

fraktguide@posten.no