Hersteller und Traktoren

Referenzdaten zu Trägerfahrzeugen: Hersteller (Marken), Traktor-Serien und Traktormodelle. Alle Endpunkte sind öffentlich.

Methode	Pfad	Paginiert
`GET`	`/manufacturers`	nein
`GET`	`/manufacturers/{slug}`	–
`GET`	`/tractor-series`	nein
`GET`	`/tractor-series/{slug}`	–
`GET`	`/tractor-models`	ja, 50 pro Seite
`GET`	`/tractor-models/{tractorModel}`	–

Felder

Hersteller

Feld	Typ	Bedeutung
`id`	Integer	ID
`slug`	String	Kennung, z. B. `john-deere`
`short_name`	String \| null	Kurzname
`names`	Objekt	Name je Sprache

Traktor-Serie

Feld	Typ	Bedeutung
`id`	Integer	ID
`slug`	String	Kennung
`names`	String \| null	Name in der Server-Sprache (derzeit Text, kein Sprach-Objekt)
`manufacturer_id`	Integer	Hersteller
`manufacturer`	Hersteller	In Liste und Detail
`models`	Traktormodell[]	Nur in der Detailansicht, ohne `manufacturer`/`series`

Traktormodell

Feld	Typ	Bedeutung
`id`	Integer	ID
`identifier`	String \| null	Kennung aus dem Quellsystem
`model`	String	Modellbezeichnung
`type_of_tractor`	String \| null	Traktorart, Freitext
`manufacturer_id`	Integer \| null	Hersteller
`tractor_series_id`	Integer \| null	Serie
`manufacturer`	Hersteller	Bei `/tractor-models` immer dabei
`series`	Serie \| null	Bei `/tractor-models` immer dabei (ohne eigenes `manufacturer`)

Hersteller auflisten

GET /manufacturers

Alle aktiven Hersteller, sortiert nach Kurzname. Keine Parameter.

curlJavaScriptPHP

bash

curl -sS https://admin.matev.eu/api/v1/manufacturers -H 'Accept: application/json'

const { data: manufacturers } = await (await fetch('https://admin.matev.eu/api/v1/manufacturers', {
  headers: { Accept: 'application/json' },
})).json()

php

use Illuminate\Support\Facades\Http;

$manufacturers = Http::acceptJson()->get('https://admin.matev.eu/api/v1/manufacturers')->throw()->json('data');

Antwort `200`

json

{
  "data": [
    { "id": 2, "slug": "fendt", "short_name": "FE", "names": { "de": "Fendt", "en": "Fendt" } },
    { "id": 4, "slug": "john-deere", "short_name": "JD", "names": { "de": "John Deere", "en": "John Deere" } }
  ]
}

Fehler

Status	`code`	Wann
405	`method_not_allowed`	andere Methode als `GET`

Einen Hersteller abrufen

GET /manufacturers/{slug}

Parameter	Ort	Typ	Bedeutung
`slug`	Pfad	String	Slug des Herstellers

Die Detailansicht hat dieselben Felder wie die Liste. Serien oder Modelle sind nicht enthalten; dafür gibt es /tractor-series und /tractor-models?manufacturer=….

curlJavaScriptPHP

bash

curl -sS https://admin.matev.eu/api/v1/manufacturers/john-deere -H 'Accept: application/json'

const { data: maker } = await (await fetch('https://admin.matev.eu/api/v1/manufacturers/john-deere', {
  headers: { Accept: 'application/json' },
})).json()

php

use Illuminate\Support\Facades\Http;

$maker = Http::acceptJson()->get('https://admin.matev.eu/api/v1/manufacturers/john-deere')->throw()->json('data');

Antwort `200`

json

{ "data": { "id": 4, "slug": "john-deere", "short_name": "JD", "names": { "de": "John Deere" } } }

Fehler

Status	`code`	Wann
404	`not_found`	Kein Hersteller mit diesem Slug, oder er ist inaktiv
405	`method_not_allowed`	andere Methode als `GET`

Traktor-Serien auflisten

GET /tractor-series

Alle Serien, sortiert nach Slug, jeweils mit Hersteller. Keine Parameter. Es gibt keinen Aktiv-Filter.

curlJavaScriptPHP

bash

curl -sS https://admin.matev.eu/api/v1/tractor-series -H 'Accept: application/json'

const { data: series } = await (await fetch('https://admin.matev.eu/api/v1/tractor-series', {
  headers: { Accept: 'application/json' },
})).json()

php

use Illuminate\Support\Facades\Http;

$series = Http::acceptJson()->get('https://admin.matev.eu/api/v1/tractor-series')->throw()->json('data');

Antwort `200`

json

{
  "data": [
    {
      "id": 17,
      "slug": "john-deere-3e",
      "names": "3E-Serie",
      "manufacturer_id": 4,
      "manufacturer": { "id": 4, "slug": "john-deere", "short_name": "JD", "names": { "de": "John Deere" } }
    }
  ]
}

Fehler

Status	`code`	Wann
405	`method_not_allowed`	andere Methode als `GET`

Eine Traktor-Serie abrufen

GET /tractor-series/{slug}

Parameter	Ort	Typ	Bedeutung
`slug`	Pfad	String	Slug der Serie

Enthält zusätzlich models.

curlJavaScriptPHP

bash

curl -sS https://admin.matev.eu/api/v1/tractor-series/john-deere-3e -H 'Accept: application/json'

const { data: serie } = await (await fetch('https://admin.matev.eu/api/v1/tractor-series/john-deere-3e', {
  headers: { Accept: 'application/json' },
})).json()

php

use Illuminate\Support\Facades\Http;

$serie = Http::acceptJson()->get('https://admin.matev.eu/api/v1/tractor-series/john-deere-3e')->throw()->json('data');

Antwort `200`

json

{
  "data": {
    "id": 17,
    "slug": "john-deere-3e",
    "names": "3E-Serie",
    "manufacturer_id": 4,
    "manufacturer": { "id": 4, "slug": "john-deere", "short_name": "JD", "names": { "de": "John Deere" } },
    "models": [
      { "id": 230, "identifier": "JD-3038E", "model": "3038E", "type_of_tractor": "Kompakttraktor", "manufacturer_id": 4, "tractor_series_id": 17 },
      { "id": 231, "identifier": "JD-3045E", "model": "3045E", "type_of_tractor": "Kompakttraktor", "manufacturer_id": 4, "tractor_series_id": 17 }
    ]
  }
}

Fehler

Status	`code`	Wann
404	`not_found`	Keine Serie mit diesem Slug
405	`method_not_allowed`	andere Methode als `GET`

Traktormodelle auflisten

GET /tractor-models

Alle Modelle, sortiert nach Modellbezeichnung, mit Hersteller und Serie, seitenweise.

Parameter	Typ	Bedeutung
`manufacturer`	String	Slug des Herstellers
`page`	Integer	Seite, Standard 1
`per_page`	Integer	Standard 50, höchstens 200

Einen Filter nach Serie gibt es hier nicht. Die Modelle einer Serie liefert /tractor-series/{slug}.

curlJavaScriptPHP

bash

curl -sS 'https://admin.matev.eu/api/v1/tractor-models?manufacturer=john-deere' -H 'Accept: application/json'

const res = await fetch('https://admin.matev.eu/api/v1/tractor-models?manufacturer=john-deere', {
  headers: { Accept: 'application/json' },
})
const { data: models, links } = await res.json()

php

use Illuminate\Support\Facades\Http;

$models = Http::acceptJson()
    ->get('https://admin.matev.eu/api/v1/tractor-models', ['manufacturer' => 'john-deere'])
    ->throw()
    ->json('data');

Antwort `200`

json

{
  "data": [
    {
      "id": 230,
      "identifier": "JD-3038E",
      "model": "3038E",
      "type_of_tractor": "Kompakttraktor",
      "manufacturer_id": 4,
      "tractor_series_id": 17,
      "manufacturer": { "id": 4, "slug": "john-deere", "short_name": "JD", "names": { "de": "John Deere" } },
      "series": { "id": 17, "slug": "john-deere-3e", "names": "3E-Serie", "manufacturer_id": 4 }
    }
  ],
  "links": { "first": "…", "last": "…", "prev": null, "next": null },
  "meta": { "current_page": 1, "per_page": 50, "total": 1, "…": "…" }
}

Fehler

Status	`code`	Wann
405	`method_not_allowed`	andere Methode als `GET`

Ein Traktormodell abrufen

GET /tractor-models/{tractorModel}

Parameter	Ort	Typ	Bedeutung
`tractorModel`	Pfad	Integer	ID des Modells

curlJavaScriptPHP

bash

curl -sS https://admin.matev.eu/api/v1/tractor-models/230 -H 'Accept: application/json'

const { data: model } = await (await fetch('https://admin.matev.eu/api/v1/tractor-models/230', {
  headers: { Accept: 'application/json' },
})).json()

php

use Illuminate\Support\Facades\Http;

$model = Http::acceptJson()->get('https://admin.matev.eu/api/v1/tractor-models/230')->throw()->json('data');

Antwort `200`

Ein Objekt wie in der Liste, in data.

Fehler

Status	`code`	Wann
404	`not_found`	Kein Modell mit dieser ID
405	`method_not_allowed`	andere Methode als `GET`

Hersteller und Traktoren ​

Felder ​

Hersteller auflisten ​

Antwort 200 ​

Fehler ​

Einen Hersteller abrufen ​

Antwort 200 ​

Fehler ​

Traktor-Serien auflisten ​

Antwort 200 ​

Fehler ​

Eine Traktor-Serie abrufen ​

Antwort 200 ​

Fehler ​

Traktormodelle auflisten ​

Antwort 200 ​

Fehler ​

Ein Traktormodell abrufen ​

Antwort 200 ​

Fehler ​

Hersteller und Traktoren

Felder

Hersteller auflisten

Antwort `200`

Fehler

Einen Hersteller abrufen

Antwort `200`

Fehler

Traktor-Serien auflisten

Antwort `200`

Fehler

Eine Traktor-Serie abrufen

Antwort `200`

Fehler

Traktormodelle auflisten

Antwort `200`

Fehler

Ein Traktormodell abrufen

Antwort `200`

Fehler