API-Dokumentation

Greifen Sie programmatisch über unsere REST-API auf Werkstoffdaten zu.

Schnellstart

Die MaterialRegistry-API ist kostenlos nutzbar und erfordert keine Authentifizierung für öffentliche Endpunkte.

curl "https://api.materialregistry.com/api/v1/materials?q=304"

Basis-URL

https://api.materialregistry.com

Endpunkte

GET /api/v1/materials

Search materials

Parameter

Name	Type	Description
q	string	Search query (e.g., "304", "1.4301")
category	string	Filter by category
limit	number	Results per page (default: 20)
offset	number	Pagination offset

Beispiel

curl "https://api.materialregistry.com/api/v1/materials?q=304"

GET /api/v1/materials/:slug

Get material by slug

Beispiel

curl "https://api.materialregistry.com/api/v1/materials/stainless-steel-304"

GET /api/v1/materials/:slug/equivalents

Get standard equivalents for a material

Beispiel

curl "https://api.materialregistry.com/api/v1/materials/stainless-steel-304/equivalents"

GET /api/v1/search/suggest

Get search suggestions (autocomplete)

Parameter

Name	Type	Description
q	string	Search query (min 2 characters)
limit	number	Max suggestions (default: 10)

Beispiel

curl "https://api.materialregistry.com/api/v1/search/suggest?q=304"

GET /api/v1/categories

List all material categories

Beispiel

curl "https://api.materialregistry.com/api/v1/categories"

GET /api/v1/standards

List all supported standards

Beispiel

curl "https://api.materialregistry.com/api/v1/standards"

Antwortformat

Alle Antworten werden als JSON mit folgender Struktur zurückgegeben:

// Success
{
  "success": true,
  "data": { ... }
}

// Error
{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable error message"
  }
}

Ratenbegrenzungen

Die öffentliche API ist auf 100 Anfragen pro Minute pro IP-Adresse begrenzt. Falls Sie höhere Limits für Ihre Anwendung benötigen, kontaktieren Sie uns bitte.