API-Dokumentation für die Produktsuche – SP-SpareParts

Beschreibung

Diese API ermöglicht Produktsuchen in der Datenbank von SP-SpareParts. Der Aufruf ist einfach und erfordert keine Authentifizierung und keine besonderen Parameter außer der Suchanfrage. Es handelt sich um eine REST-API, die Ergebnisse im JSON-Format zurückgibt. Außerdem kann eine direkte Suche über den Browser durchgeführt werden, um Ergebnisse im HTML-Format zu erhalten.

---

API-Zugriff (JSON)

Um Ergebnisse im JSON-Format zu erhalten:

https://www.sp-recambios.es/es/s/api?query=[query]

Direkter Zugriff über den Browser (HTML)

Um Ergebnisse im HTML-Format zu erhalten:

https://www.sp-recambios.es/es/search?query=[query]

Methode

GET

Abfrageparameter

• [query] (erforderlich): Suchtext für das gewünschte Produkt. Beispiel: R165139370

Beispielaufruf

https://www.sp-recambios.es/es/s/api?query=R165139370

---

Antwort (JSON)

Die API gibt ein JSON-Objekt mit relevanten Informationen zum gesuchten Produkt zurück. Nachfolgend ein Beispiel für eine Antwort:

{
    "items": [
        {
            "id": 297800,
            "url": "https:\/\/www.sp-recambios.es\/es\/p\/r165139370-bosch-rexroth?_q=R165139370",
            "price": "$373.16",
            "search": "R165139370 REXROTH",
            "availability": "available",
            "partnumber": "R165139370",
            "imageurl": "https:\/\/cdn.sp-spareparts.com\/assets\/img\/category\/bosch\/category-112.big.jpg",
            "catalognumber": "KWD-035-FNS-C0-H-1",
            "brand": {
                "id": 27,
                "name": "REXROTH"
            },
            "category": {
                "name": "FNS, standard, Resist NR II, with ball chain",
                "path": "linear motion technology > profiled rail systems > ball rail systems > ball runner blocks > fns, standard, resist nr ii, with ball chain"
            },
            "attributes": [
                {
                    "name": "Size",
                    "value": "35"
                },
                {
                    "name": "Preload class",
                    "value": "C0"
                },
                {
                    "name": "Accuracy class",
                    "value": "H"
                },
                {
                    "name": "Weight",
                    "value": "1.70Kg"
                }
            ]
        }
    ]
}

Antwortfelder

• items: Liste der gefundenen Produkte (kann leer sein, wenn keine Ergebnisse vorliegen). Jedes Produkt enthält:
• items[].id: Eindeutige Produkt-ID.
• items[].url: URL zum Produkt auf der Website.
• items[].price: Einzelpreis des Produkts.
• items[].search: Zugehöriger Suchbegriff.
• items[].availability: Verfügbarkeit des Produkts (z. B. „available“, „limited stock“).
• items[].partnumber: Produktcode.
• items[].imageurl: Bild-URL des Produkts.
• items[].catalognumber: Katalognummer des Produkts.
• items[].brand: Informationen zur Marke (Name und ID).
• items[].category: Produktkategorie und ihr hierarchischer Pfad.
• items[].attributes: Liste der produktspezifischen Attribute (Name und Wert).

Fehlercode

Wenn für die angegebene Abfrage keine Produkte gefunden werden, kann die Antwort eine leere Liste oder eine benutzerdefinierte Fehlermeldung sein.

---

Zusätzliche Hinweise

• Die API antwortet schnell und erfordert keine Authentifizierung.