Auto-Saksasta — rajapinta sisäänostajille

Aloitus

Sait meiltä henkilökohtaisen tokenin. Se tunnistaa sinut jokaisessa kutsussa, eikä muuta kirjautumista tarvita. Token on pitkäikäinen — sen voi tallentaa järjestelmääsi kertaalleen.

Token on salasanan veroinen. Älä laita sitä selaimessa ajettavaan koodiin äläkä julkiseen repositorioon. Kutsut palvelimeltasi. Jos token vuotaa, soita 010 320 8080 — suljemme sen ja saat uuden saman tien.

Perusosoite:

https://auto-saksasta.fi/ostaja_api.php

Kaikki vastaukset ovat JSON-muotoisia ja sisältävät kentän ok. Virhetilanteessa mukana on error ja HTTP-tilakoodi kertoo syyn.

Päätepisteet

GET `?action=whoami&t=…`

Tarkistaa että token toimii ja palauttaa omat tietosi. Kätevä ensimmäiseksi kutsuksi integraatiota rakentaessa.

GET `?action=cars&t=…`

Kaikki sinulle tarjolla olevat autot. Järjestys: vaihtopäivän mukaan, aikaisin ensin.

{
  "ok": true,
  "lukumaara": 1,
  "autot": [
    {
      "id": "36gg5h4je5",
      "auto": "Volvo XC60 B4 AWD",
      "vin": "YV1UZ...",
      "taso": "omistaja",
      "taso_selite": "Omistajan oma skannaus — omistajan ilmoittamia tietoja, EI kuntotarkastus",
      "vaihtopaiva": "2026-09-12",
      "pyyntihinta": 18500,
      "heti_hinta": 21000,
      "kuntopisteet": null,
      "paivitetty": "2026-08-05 07:37:31",
      "linkki": "https://auto-saksasta.fi/ostaja_api.php?action=car&t=…&id=36gg5h4je5"
    }
  ]
}

GET `?action=car&t=…&id=…`

Yhden auton koko data: renkaat, tarkistuslista, viat, maalipaksuudet, lisävarusteet ja kuvien osoitteet.

GET `?action=photo&t=…&id=…&key=…&n=0`

Yksi kuva binäärinä oikealla content-typellä. Osoitteet tulevat valmiina car-vastauksen kuvat-listassa — älä muodosta niitä itse.

Kaksi tarkastustasoa — lue tämä

Jokaisessa vastauksessa on kenttä taso. Se kertoo mihin auton tiedot perustuvat, ja ero on olennainen.

taso	Mitä se tarkoittaa
`laaja`	Riippumaton kuntotarkastus. Tarkastajamme on käynyt auton luona. Mitatut arvot: maalipinnan paksuudet, urasyvyydet, tarkastuslista, vikakoodit. Mukana tarkastajan nimi ja päivämäärä.
`omistaja`	Omistajan oma skannaus — ei kuntotarkastus. Auton omistaja on kuvannut auton ja vastannut kysymyksiin itse. Emme ole todentaneet tietoja. Tarkistuslistalla on myös vastaus "En osaa sanoa", joka tarkoittaa juuri sitä.

Näytä taso omassa järjestelmässäsi. Jos omistaja-tason auto näkyy myyjillenne mitattuna tarkastuksena, virhe tulee vastaan luovutuksessa — ja se on huono kummallekin.

Mitä rajapinta EI sisällä

Asiakkaan henkilötietoja ei palauteta. Nimi, yhteystiedot ja osoite eivät kulje rajapinnan kautta. Saat ne vasta kun kauppa syntyy, ja silloin niiden käyttöä rajaavat tarjousehdot: tietoja saa käyttää vain kaupan toteuttamiseen, ei markkinointiin.

Esimerkit

curl

curl -s "https://auto-saksasta.fi/ostaja_api.php?action=cars&t=$TOKEN"

PHP

<?php
$token = getenv('AS_OSTAJA_TOKEN');           // ei koodiin kovakoodattuna
$url   = 'https://auto-saksasta.fi/ostaja_api.php?action=cars&t=' . rawurlencode($token);
$data  = json_decode(file_get_contents($url), true);

foreach ($data['autot'] as $auto) {
    // Näytä taso myyjälle — mitattu ja kerrottu eivät ole sama asia
    printf("%-28s %s  vaihtopäivä %s\n",
        $auto['auto'], $auto['taso'], $auto['vaihtopaiva'] ?? 'heti');
}

Python

import os, requests

TOKEN = os.environ["AS_OSTAJA_TOKEN"]
BASE  = "https://auto-saksasta.fi/ostaja_api.php"

autot = requests.get(BASE, params={"action": "cars", "t": TOKEN}, timeout=20).json()

for a in autot["autot"]:
    auto = requests.get(BASE, params={"action": "car", "t": TOKEN,
                                      "id": a["id"]}, timeout=20).json()["auto"]
    print(a["auto"], "|", a["taso"], "|", len(auto["kuvat"]), "kuvaa")

Node

const TOKEN = process.env.AS_OSTAJA_TOKEN;
const BASE  = 'https://auto-saksasta.fi/ostaja_api.php';

const r = await fetch(`${BASE}?action=cars&t=${encodeURIComponent(TOKEN)}`);
const { autot } = await r.json();

for (const a of autot) {
  console.log(a.auto, a.taso, a.vaihtopaiva ?? 'heti');
}

Käytännön ohjeita

Hae listaus kerran tunnissa, älä minuutin välein. Autot eivät vaihdu niin nopeasti, ja turha kuormitus hidastaa kaikkia.

Kuvat kannattaa kopioida omaan järjestelmääsi kerran auton kohdalla. Ne eivät muutu, ja oma kopio on nopeampi kuin meidän palvelimemme.

Vaihtopäivä voi siirtyä. Se on arvio päivästä, jona asiakkaan uusi auto saapuu ja vaihtoauto vapautuu. Tarkista se ennen luovutuksen sopimista. null tarkoittaa että auto on heti vapaa.

Virhekoodit: 401 token puuttuu tai on tuntematon · 403 token on suljettu · 404 autoa ei löydy tai se ei ole enää myynnissä.

Kysyttävää

Soita 010 320 8080 tai kirjoita info@auto-saksasta.fi. Jos tarvitset kenttiä joita rajapinnassa ei ole, kerro mitä — lisääminen on yleensä helppoa.