JSON API 1.0

Checkplate Light

Abruf von Details zu einem Zulassungsbezirk
Beispiel Request: https://www.carangoo.com/api/checkplatelight/AÖ

Beispiel JSON Response:
{
"landkreis":"Alt\u00f6tting",
"landkreis_valid":true,
"bundesland":"Bayern",
"latitude":"48.2279266",
"longitude":"12.6788666",
"bundesland_image":"http:\/\/www.carangoo.com\/images\/bundesland\/BY.png"
}

Checkplate

Abruf von Details zu einem Kennzeichen
Beispiel Request: https://www.carangoo.com/api/checkplate/APIKEY/D-R-959

Beispiel JSON Response:
{
"kennzeichen":"D-R-959",
"apikey_valid":true,
"landkreis_valid":true,
"kennzeichen_valid":true,
"kennzeichen_registered":true,
"kennzeichen_normiert":"D-R-959",
"kennzeichen_url":"D-R-959",
"messages":"33",
"landkreis":"D\u00fcsseldorf",
"bundesland":"Nordrhein-Westfalen",
"latitude":"51.2249429",
"longitude":"6.77565240",
"carangoomail":"D-R-959@carangoo.com",
"kennzeichen_link":"http:\/\/www.carangoo.com\/show_kennzeichen3.php?kennzeichen=D-R-959",
"myprofile_link":"http:\/\/www.carangoo.com\/mycarangoo.php?user=D-R-959",
"bundesland_image":"http:\/\/www.carangoo.com\/images\/bundesland\/NRW.png"
}

Sendmsg

Senden einer Nachricht MESSAGE an ein Kennzeichen
Beispiel Request: https://www.carangoo.com/api/sendmsg/APIKEY/D-R-959/MESSAGE

Beispiel JSON Response:
{
"kennzeichen":"D-R-959",
"apikey_valid":true,
"kennzeichen_valid":true,
"message_delivered":true
}

Register

Registrieren eines neuen Accounts für ein Kennzeichen
Beispiel Request: https://www.carangoo.com/api/register/APIKEY/D-R-959/E-Mail/Password

Beispiel JSON Response:
{
"kennzeichen":"D-R-959",
"apikey_valid":true,
"registration_ok":true,
"status":"100 OK"
}

status:
100 OK
200 Kennzeichen ungültig
300 Kennzeichen bereits registriert
400 E-Mail Adresse ist ungültig
500 Passwort ist ungültig


Getmessages

Alle Nachrichten für ein Kennzeichen abrufen
Beispiel Request: https://www.carangoo.com/api/getmessages/APIKEY/D-R-959/Password

Beispiel JSON Response:
{
"kennzeichen":"D-R-959",
"apikey_valid":true,
"kennzeichen_registered":true,
"status":"100 OK"
"msgcount":2,
"message":
[
{"message_id":"123","message":"testnachricht","timestamp":"19.04.2013 14:37","sender":"API"},
{"message_id":"345","message":"noch eine testnachricht","timestamp":"19.04.2013 14:35","sender":"EMAIL"}
]
}

status:
100 OK
200 Kennzeichen ungültig
500 Passwort ist ungültig
600 Kennzeichen noch nicht registriert


Getallplates (Experimental)

Alle Landkreise ausgeben
Beispiel Request: https://www.carangoo.com/api/getallplates/APIKEY