OEMline Dashboard

API Reference

Use these endpoints in your frontend to access the OEMline platform

Base URL & Authentication

Base URL

https://api-bsg4wgow80c8k4sc404ko00k.oemline.eu

Authentication

All endpoints (except /health) require the X-API-Key header.

Header: X-API-Key: your-api-key

Status

Checking...

GET

/health

System

System health check — no authentication required

RESPONSE

{ status, uptime, timestamp, checks: { postgres, redis, meilisearch }, queues: { sync, match, index }, circuits: { ... } }

GET

/api/search

Search products across all suppliers and TecDoc cross-reference

PARAMETERS

Name	Type	Required	Description
q	string	required	Search query (article number, OEM, EAN, or free text)
brand	string	optional	Filter by brand name
articleNo	string	optional	Filter by article number
ean	string	optional	Filter by EAN barcode
tecdocId	string	optional	Filter by TecDoc ID
oem	string	optional	Filter by OEM number
limit	number	optional	Max results (default: 50, max: 200)

RESPONSE

{ query, results: [{ supplier, sku, brand, articleNo, ean, tecdocId, oem, description, price, stock, currency }], matches, errors, totalResults, cachedAt }

EXAMPLE

curl -H "X-API-Key: $API_KEY" "https://api-bsg4wgow80c8k4sc404ko00k.oemline.eu/api/search?q=04E115561H"

GET

/api/tecdoc/search

TecDoc

Search TecDoc catalog directly (article number, OEM, EAN)

PARAMETERS

Name	Type	Required	Description
q	string	required	Search query
type	string	optional	Search type: article, oem, ean, free (default: free)
brandId	number	optional	Filter by TecDoc brand ID
page	number	optional	Page number (default: 1)
limit	number	optional	Results per page (default: 25)

RESPONSE

{ articles: [{ articleNumber, brand, brandId, description, ean, oemNumbers, tecdocId }], total }

EXAMPLE

curl -H "X-API-Key: $API_KEY" "https://api-bsg4wgow80c8k4sc404ko00k.oemline.eu/api/tecdoc/search?q=04E115561H&type=oem"

GET

/api/suppliers

Suppliers

List all registered suppliers with product counts

PARAMETERS

Name	Type	Required	Description
page	number	optional	Page number
limit	number	optional	Items per page (max: 100)
active	string	optional	Filter: true, false, or all

RESPONSE

{ items: [{ id, name, code, adapterType, baseUrl, priority, active, _count: { productMaps, overrides, unmatched } }], total, page, limit, totalPages }

POST

/api/suppliers

Suppliers

PARAMETERS

Name	Type	Required	Description
name	string	required	Supplier display name
code	string	required	Unique code (lowercase, a-z0-9_-)
adapterType	string	required	Adapter: intercars, tecdoc, partspoint
baseUrl	string	required	API base URL
credentials	object	required	Encrypted credentials (key-value pairs)
priority	number	optional	Sort order (lower = higher priority)
active	boolean	optional	Enable supplier (default: true)

RESPONSE

{ id, name, code, adapterType, baseUrl, priority, active, message }

PATCH

/api/suppliers/:id

Suppliers

Update supplier settings

PARAMETERS

Name	Type	Required	Description
name	string	optional	Supplier name
active	boolean	optional	Enable/disable supplier
priority	number	optional	Sort priority
credentials	object	optional	Update credentials

RESPONSE

{ id, name, code, active, priority, message }

POST

/api/suppliers/:id/sync

Suppliers

Trigger catalog sync for a supplier (BullMQ job)

RESPONSE

{ message, jobId, supplier }

GET

/api/overrides

Overrides

List manual product matching overrides

PARAMETERS

Name	Type	Required	Description
page	number	optional	Page number
limit	number	optional	Items per page
supplierCode	string	optional	Filter by supplier code

RESPONSE

{ items: [{ id, articleNo, sku, ean, tecdocId, oem, reason, createdBy, active, supplier, brand }], total, page, limit, totalPages }

POST

/api/override

Overrides

Create a manual product matching override

PARAMETERS

Name	Type	Required	Description
supplierCode	string	required	Supplier code
brandCode	string	required	Brand code
articleNo	string	required	Article number
sku	string	required	Supplier SKU
ean	string	optional	EAN barcode
tecdocId	string	optional	TecDoc ID
oem	string	optional	OEM number
reason	string	optional	Override reason

RESPONSE

{ id, articleNo, sku, ean, tecdocId, oem, reason, active }

GET

/api/unmatched

Unmatched

List items that could not be matched automatically

PARAMETERS

Name	Type	Required	Description
page	number	optional	Page number
limit	number	optional	Items per page
resolved	string	optional	Filter: true, false, all (default: false)

RESPONSE

{ items: [{ id, query, articleNo, ean, tecdocId, oem, attempts, resolvedAt, supplier, brand }], total, page, limit, totalPages }

GET

/api/trace/logs

Analytics

Match analytics and audit trail

PARAMETERS

Name	Type	Required	Description
page	number	optional	Page number
limit	number	optional	Items per page (max: 200)
matched	string	optional	Filter: true, false, all
method	string	optional	Match method: override, tecdocId, ean, brand_article, oem
supplierId	number	optional	Filter by supplier ID
from	string	optional	Date from (ISO 8601)
to	string	optional	Date to (ISO 8601)

RESPONSE

{ items: [{ id, query, sku, method, confidence, matched, durationMs, createdAt, supplier, brand }], total, page, limit, totalPages, stats: [{ method, count, avgDurationMs, avgConfidence }] }

Quick Integration

Use these endpoints from your frontend to build a complete automotive parts e-commerce experience.

// JavaScript / TypeScript

const API_URL = "https://api-bsg4wgow80c8k4sc404ko00k.oemline.eu";

const API_KEY = "your-api-key";

const response = await fetch(`${API_URL}/api/search?q=04E115561H`, {

headers: { "X-API-Key": API_KEY }

});

const data = await response.json();

// data.results → [{ supplier, brand, articleNo, description, price, stock }]

Product Search

Search by OEM, article number, EAN, or free text. Returns results from all active suppliers + TecDoc cross-reference.

GET /api/search?q=...

TecDoc Catalog

Direct TecDoc search for article numbers, OEM cross-reference, and EAN lookups.

GET /api/tecdoc/search?q=...

Supplier Data

List suppliers, trigger catalog syncs, manage overrides.

GET /api/suppliers