PAP-API på GitHub

Öppet API som kontrollerar och verifierar svenska adresser och postnummer

Antal adresser

0

Antal postnummer

0

Antal postorter

0

Registrera och börja använda

Öppet och fritt

Full tillgång och fri användning utan några förbehåll. Det enda som krävs är registrering.

Månatliga uppdateringar

Registret uppdateras en gång per månad för att hålla alla uppgifter färska och tillförlitliga.

Kostnadseffektivt

Slipp onödiga kostnader för till exempel utskick av försändelser till felaktiga adresser.

Användning

PAP-API är fritt att använda och kommer så alltid att vara. Däremot kan onormalt hög användning resultera i avstängning, men det är vid fler än 5000 förfrågningar per användare och dag.

Innan du kan börja använda PAP-API måste du registrera dig med för- och efternamn samt e-postadress. Efter att du har verifierat din e-postadress får du en unik "token" eller nyckel som ger dig full tillgång till PAP-API.

OBS! Registrerade uppgifter lämnas ALDRIG ut till tredje part.

Specifikation

Parameter Förklaring Exempel
z Postnummer z=114+34
s Adress s=Birger+Jarlsgatan eller s=Birger+Jarlsgatan+10
c Postort c=Stockholm
v Adressvalidering v=Birger+Jarlsgatan|10|114+34|Stockholm

OBS! Endast parametrarna s (adress) och c (postort) kan kombineras. Vid adressvalidering separera gatunamn, gatunummer, postnummer och postort med | (vertikalstreck). Inga värden får innehålla mellanslag utan måste ersättas med + (plus).

Statuskoder vid adressvalidering

Statuskod Förklaring
100 Korrekt angiven adress
200 Felaktigt gatunummer för angiven adress
300 Felaktigt gatunamn och/eller gatunummer för angiven adress
400 Felaktig postort för angiven adress
500 Felaktigt postnummer för angiven adress
600 Felaktigt gatunummer och postort för angiven adress
700 Felaktigt gatunummer och postnummer för angiven adress
800 Felaktigt angiven adress
900 Generellt felmeddelande

Förfrågning Request

Exempel på möjliga förfrågningar.

XML

Adress + Postort
http://papapi.se/xml/?s=Birger+Jarlsgatan&c=Stockholm&token=DIN_TOKEN

Adress + Nummer + Postort
http://papapi.se/xml/?s=Birger+Jarlsgatan+10&c=Stockholm&token=DIN_TOKEN

Adress
http://papapi.se/xml/?s=Birger+Jarlsgatan&token=DIN_TOKEN

Adress + Nummer
http://papapi.se/xml/?s=Birger+Jarlsgatan+10&token=DIN_TOKEN

Postnummer
http://papapi.se/xml/?z=114+34&token=DIN_TOKEN

Postort
http://papapi.se/xml/?c=Stockholm&token=DIN_TOKEN

Adressvalidering
http://papapi.se/xml/?v=Birger+Jarlsgatan|10|114+34|Stockholm&token=DIN_TOKEN

JSON

Adress + Postort
http://papapi.se/json/?s=Birger+Jarlsgatan&c=Stockholm&token=DIN_TOKEN

Adress + Nummer + Postort
http://papapi.se/json/?s=Birger+Jarlsgatan+10&c=Stockholm&token=DIN_TOKEN

Adress
http://papapi.se/json/?s=Birger+Jarlsgatan&token=DIN_TOKEN

Adress + Nummer
http://papapi.se/json/?s=Birger+Jarlsgatan+10&token=DIN_TOKEN

Postnummer
http://papapi.se/json/?z=114+34&token=DIN_TOKEN

Postort
http://papapi.se/json/?c=Stockholm&token=DIN_TOKEN

Adressvalidering
http://papapi.se/json/?v=Birger+Jarlsgatan|10|114+34|Stockholm&token=DIN_TOKEN


Svar Response

OBS! Max 200 poster per svar.

XML

<result>
  <api>
  <name>PAP-API</name>
  <url>HTTP://WWW.PAPAPI.SE/</url>
  <version>1.21</version>
  <encoding>UTF-8</encoding>
  </api>
  <item>
    <street>BIRGER JARLSGATAN</street>
    <number>2-14</number>
    <zipcode>114 34</zipcode>
    <city>STOCKHOLM</city>
    <municipality>STOCKHOLM</municipality>
    <code>0180</code>
    <state>STOCKHOLM</state>       
  </item>
</result>

XML vid adressvalidering

<result>
  <api>
  <name>PAP-API</name>
  <url>HTTP://WWW.PAPAPI.SE/</url>
  <version>1.21</version>
  <encoding>UTF-8</encoding>
  </api>
  <address>
    <street>BIRGER JARLSGATAN</street>
    <number>10</number>
    <zipcode>114 34</zipcode>
    <city>STOCKHOLM</city>      
  </address>
  <status>
    <code>100</code>
    <description_sv>KORREKT ANGIVEN ADRESS</description_sv>
    <description_en>CORRECT SPECIFIED ADDRESS</description_en>     
  </status>
</result>

JSON

{   
  "api":{
      "name":"PAP-API",
      "url":"HTTP://WWW.PAPAPI.SE/",
      "version":"1.21",
      "encoding":"UTF-8"        
    },
  "result":[{
      "street":"BIRGER JARLSGATAN",
      "number":"2-14",
      "zipcode":"114 34",
      "city":"STOCKHOLM",
      "municipality":"STOCKHOLM",
      "code":"0180",
      "state":"STOCKHOLM"         
    }]
}

JSON vid adressvalidering

{   
  "api":{
      "name":"PAP-API",
      "url":"HTTP://WWW.PAPAPI.SE/",
      "version":"1.21",
      "encoding":"UTF-8"        
    },
  "result":{
      "address":{
        "street":"BIRGER JARLSGATAN",
        "number":"10",
        "zipcode":"114 34",
        "city":"STOCKHOLM"
      },
      "status":{
        "code":"100",
        "description_sv":"KORREKT ANGIVEN ADRESS",
        "description_en":"CORRECT SPECIFIED ADDRESS"
      } 
    }
}


Kodexempel PHP

XML TILL PHP

$token  = 'DIN_TOKEN';
$url    = 'http://papapi.se/xml/?s=Birger+Jarlsgatan+10&c=Stockholm&token='.$token;

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$xml = simplexml_load_string($response);

if ($xml->item) {
  // LISTAR RESULTATET
  foreach($xml->item as $item) {
    echo '<p>';
    echo 'Gata: '.$item->street.'<br>';
    echo 'Nummer: '.$item->number.'<br>';
    echo 'Postnummer: '.$item->zipcode.'<br>';
    echo 'Ort: '.$item->city.'<br>';
    echo 'Kommun: '.$item->municipality.'<br>';
    echo 'Kommunkod: '.$item->code.'<br>';
    echo 'Län: '.$item->state;
    echo '</p>';
  }
} else {
  // TOMT RESULTAT
  echo 'Gav inget resultat!';
}

JSON TILL PHP

$token  = 'DIN_TOKEN';
$url    = 'http://papapi.se/json/?s=Birger+Jarlsgatan+10&c=Stockholm&token='.$token;

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$json = json_decode($response, true);

if (!$json['result']['message']) {
  // LISTAR RESULTATET
  foreach($json['result'] as $key => $val) {
    echo '<p>';
    echo 'Gata: '.$val['street'].'<br>';
    echo 'Nummer: '.$val['number'].'<br>';
    echo 'Postnummer: '.$val['zipcode'].'<br>';
    echo 'Ort: '.$val['city'].'<br>';
    echo 'Kommun: '.$val['municipality'].'<br>';
    echo 'Kommunkod: '.$val['code'].'<br>';
    echo 'Län: '.$val['state'];
    echo '</p>';
  }
} else {
  // TOMT RESULTAT
  echo 'Gav inget resultat!';
}

Tjänstens upptid

Senaste dagen

100 %

Senaste veckan

100 %

Senaste månaden

100 %

Senaste året

100 %

Upptidsövervakningen tillhandahålls av Uptime Robot.

Donera gärna!

PAP-API är öppet och fritt för all framtid. Men... det är inte gratis att tillhandahålla en tjänst som denna. Alla timmar som investeras på utveckling, vidarutveckling, uppdateringar och support. Dessutom kostar även domän och server samt den färska och tillförlitliga datan som du får tillgång till helt gratis.

Att donera är helt frivilligt men donationer bidrar starkt till fortsatt utveckling av PAP-API.