Overzicht Authenticatie Snelheidslimieten Antwoordformaat Producten Bulk-voorraadupdate Bulk-prijsupdate Bestellingen Categorieën Foutcodes Codevoorbeelden

Verdmarket Leveranciers-API

REST-API voor het programmatisch beheren van uw producten, voorraad, prijzen en bestellingen.

Basis-URL

https://verdmarket.com.mature-black-wombat.65-108-70-81.cpanel.site/api/v1/supplier

Beschikbare eindpunten

Methode	Eindpunt	Beschrijving
GET	/products	Producten weergeven
GET	/products/{id}	Productdetails ophalen
POST	/products	Product aanmaken
POST	/products/{id}	Product bijwerken
POST	/products/{id}/delete	Product verwijderen
GET	/products/{id}/images	Productafbeeldingen ophalen
POST	/products/{id}/images	Afbeeldingen toevoegen via URL
POST	/products/{id}/images/{imageId}/delete	Afbeelding verwijderen
POST	/products/{id}/images/{imageId}/primary	Hoofdafbeelding instellen
POST	/stock	Bulk-voorraadupdate
POST	/prices	Bulk-prijsupdate
GET	/orders	Bestellingen weergeven
GET	/orders/{id}	Besteldetails ophalen
POST	/orders/{id}/status	Bestelstatus bijwerken
GET	/categories	Categorieën weergeven

Authenticatie

Alle API-verzoeken vereisen een Bearer-token in de Authorization-header.

Maak uw API-sleutel aan via Leveranciersdashboard → Winkelprofiel → API-sleutels.

Authorization: Bearer YOUR_API_KEY

Belangrijk: Uw API-sleutel wordt slechts één keer getoond bij aanmaak. Bewaar deze veilig. Sleutels worden op onze servers gehasht — wij kunnen ze niet ophalen. Bij verlies: trek de oude in en maak een nieuwe aan.

Snelheidslimieten

Standaard: 1.000 verzoeken per uur per API-sleutel.

Snelheidslimiet-informatie wordt in antwoord-headers teruggegeven:

Header	Beschrijving
X-RateLimit-Limit	Maximaal aantal verzoeken per uur
X-RateLimit-Remaining	Resterende verzoeken in huidig venster
X-RateLimit-Reset	Unix-tijdstempel wanneer het venster wordt gereset
Retry-After	Seconden tot opnieuw proberen (alleen bij 429)

Antwoordformaat

Alle antwoorden zijn JSON. Succesvolle antwoorden:

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

Foutantwoorden:

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Name is required."
  }
}

Producten

GET /products

Lijst uw producten met paginering en filtering.

Queryparameters

Parameter	Type	Beschrijving
page	int	Paginanummer (standaard: 1)
per_page	int	Items per pagina (max: 100, standaard: 20)
status	string	Filter: active, inactive, pending
search	string	Zoeken op naam of SKU

Voorbeeldantwoord

{
  "success": true,
  "data": {
    "products": [
      {
        "id": 42,
        "name": "Red Roses Premium",
        "sku": "ROSE-RED-001",
        "type": "flower",
        "base_price": 2.50,
        "unit": "stem",
        "stock_qty": 500,
        "stock_status": "in_stock",
        "is_active": true,
        "is_approved": true,
        "category": { "id": 3, "name": "Roses" },
        "primary_image": "/uploads/products/rose-red.jpg"
      }
    ],
    "pagination": {
      "current_page": 1,
      "total_pages": 5,
      "total_items": 94,
      "per_page": 20
    }
  }
}

GET /products/{id}

Eén product ophalen met afbeeldingen en varianten.

POST /products

Nieuw product aanmaken. Nieuwe producten vereisen goedkeuring van de beheerder voordat ze in de catalogus verschijnen.

Verzoekbody (JSON)

Veld	Type	Verplicht	Beschrijving
name	string	*	Productnaam
category_id	int	*	Categorie-ID
base_price	float	*	Prijs in EUR
unit	string	*	steel, bos, doos, pak, stuk, kilogram, meter, rol
type	string		bloem (standaard) of supply
description	string		Productbeschrijving
sku	string		Unieke SKU (gecontroleerd op duplicaten)
stock_qty	int		Voorraadhoeveelheid (standaard: 0)
min_order_qty	int		Minimale bestelhoeveelheid (standaard: 1)
color	string		Productkleur
stem_length	int		Steellengte in cm
country_of_origin	string		Land van herkomst
vat_rate	float		BTW-tarief in % (standaard: 21)
image_url	string		Afbeelding-URL(s). Ondersteunt jpg, png, webp. Meerdere URLs gescheiden door puntkomma (;). Max. 10 afbeeldingen per product.

POST /products/{id}

Bestaand product bijwerken. Stuur alleen de velden die u wilt wijzigen (gedeeltelijke update).

POST /products/{id}/delete

Product als verwijderd markeren. Geen verzoekbody vereist.

Productafbeeldingen

Afbeeldingslimieten: Max. 10 afbeeldingen per product. Formaten: JPEG, PNG, WebP. Max. bestandsgrootte: 5 MB per afbeelding. Afbeeldingen worden gedownload van de opgegeven URLs — de server haalt ze automatisch op.

GET /products/{id}/images

Alle afbeeldingen van een product ophalen. Retourneert URLs en hoofdafbeelding-vlag.

Voorbeeldantwoord

{
  "success": true,
  "data": {
    "images": [
      {
        "id": 1,
        "url": "/uploads/products/abc123.jpg",
        "thumbnail_url": "/uploads/products/thumb_abc123.jpg",
        "is_primary": true
      },
      {
        "id": 2,
        "url": "/uploads/products/def456.jpg",
        "thumbnail_url": "/uploads/products/thumb_def456.jpg",
        "is_primary": false
      }
    ]
  }
}

POST /products/{id}/images

Afbeeldingen toevoegen via URL. De server downloadt, valideert (jpg/png/webp, max. 5 MB) en maakt automatisch thumbnails. Gebruik puntkomma's voor meerdere URLs.

Verzoekbody (JSON)

Veld	Type	Verplicht	Beschrijving
image_url	string	*	Afbeelding-URL(s). Ondersteunt jpg, png, webp. Meerdere URLs gescheiden door puntkomma (;). Max. 10 afbeeldingen per product.

Verzoekbody

{
  "image_url": "https://example.com/images/rose.jpg;https://example.com/images/rose-2.jpg"
}

POST /products/{id}/images/{imageId}/delete

Productafbeelding verwijderen. Het bestand wordt van de server verwijderd. Als de verwijderde afbeelding de hoofdafbeelding was, wordt automatisch de volgende afbeelding de hoofdafbeelding.

POST /products/{id}/images/{imageId}/primary

Stel een afbeelding in als hoofdafbeelding. De hoofdafbeelding wordt getoond in catalogusoverzichten en zoekresultaten.

Bulk-voorraadupdate

POST /stock

Voorraadhoeveelheden voor meerdere producten tegelijk bijwerken. Identificeer producten op product_id of sku. Max 500 items per verzoek.

Verzoekbody

{
  "items": [
    { "product_id": 42, "stock_qty": 500 },
    { "sku": "ROSE-RED-001", "stock_qty": 250 },
    { "sku": "LILY-WHT-003", "stock_qty": 0 }
  ]
}

Antwoord

{
  "success": true,
  "data": {
    "updated": 2,
    "failed": 1,
    "errors": [
      { "index": 2, "sku": "LILY-WHT-003", "error": "Product not found" }
    ]
  }
}

Bulk-prijsupdate

POST /prices

Prijzen voor meerdere producten bijwerken. Zelfde formaat als voorraadupdate maar met base_price-veld. Max 500 items.

Verzoekbody

{
  "items": [
    { "product_id": 42, "base_price": 2.75 },
    { "sku": "ROSE-RED-001", "base_price": 3.10 }
  ]
}

Bestellingen

GET /orders

Lijst uw bestellingsgroepen (leverancierspecifieke besteldelen).

Queryparameters

Parameter	Type	Beschrijving
page	int	Paginanummer
per_page	int	Items per pagina (max 100)
status	string	pending, confirmed, processing, shipped, delivered, completed, cancelled

GET /orders/{id}

Volledige besteldetails ophalen inclusief items, klantinformatie en statusgeschiedenis.

POST /orders/{id}/status

Bestelstatus bijwerken. Alleen geldige overgangen zijn toegestaan:

Van	Toegestane overgangen
pending	confirmed, cancelled
confirmed	processing, cancelled
processing	shipped, cancelled
shipped	delivered

Verzoekbody

{
  "status": "confirmed",
  "comment": "Order confirmed, preparing for shipment"
}

Categorieën

GET /categories

Alle actieve categorieën weergeven. Geeft een platte lijst met ouderreferenties.

Voorbeeldantwoord

{
  "success": true,
  "data": {
    "categories": [
      { "id": 1, "name": "Flowers", "slug": "flowers", "parent_id": null, "type": "flower" },
      { "id": 3, "name": "Roses", "slug": "roses", "parent_id": 1, "type": "flower" }
    ]
  }
}

Foutcodes

HTTP	Code	Beschrijving
401	UNAUTHORIZED	Ontbrekende of ongeldige API-sleutel
403	FORBIDDEN	Sleutel ingetrokken of leverancier niet geverifieerd
404	NOT_FOUND	Bron niet gevonden
422	VALIDATION_ERROR	Ongeldige invoergegevens
429	RATE_LIMITED	Snelheidslimiet overschreden
500	SERVER_ERROR	Interne serverfout

Codevoorbeelden

Producten weergeven

curl -X GET "https://verdmarket.com.mature-black-wombat.65-108-70-81.cpanel.site/api/v1/supplier/products?page=1&per_page=10" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Product aanmaken

curl -X POST "https://verdmarket.com.mature-black-wombat.65-108-70-81.cpanel.site/api/v1/supplier/products" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Red Roses Premium",
    "category_id": 3,
    "base_price": 2.50,
    "unit": "stem",
    "stock_qty": 500,
    "sku": "ROSE-RED-001",
    "color": "Red",
    "stem_length": 60,
    "country_of_origin": "Netherlands",
    "image_url": "https://example.com/images/rose-red.jpg"
  }'

Productafbeeldingen toevoegen

curl -X POST "https://verdmarket.com.mature-black-wombat.65-108-70-81.cpanel.site/api/v1/supplier/products/42/images" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/img/photo1.jpg;https://example.com/img/photo2.jpg"
  }'

Bulk-voorraadupdate

curl -X POST "https://verdmarket.com.mature-black-wombat.65-108-70-81.cpanel.site/api/v1/supplier/stock" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {"sku": "ROSE-RED-001", "stock_qty": 500},
      {"sku": "LILY-WHT-003", "stock_qty": 200}
    ]
  }'

PHP-voorbeeld

<?php
$apiKey = 'YOUR_API_KEY';
$baseUrl = 'https://verdmarket.com.mature-black-wombat.65-108-70-81.cpanel.site/api/v1/supplier';

// List products
$ch = curl_init("$baseUrl/products?page=1&per_page=10");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer $apiKey",
        "Accept: application/json",
    ],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

// Bulk stock update
$ch = curl_init("$baseUrl/stock");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode([
        'items' => [
            ['sku' => 'ROSE-RED-001', 'stock_qty' => 500],
            ['sku' => 'LILY-WHT-003', 'stock_qty' => 200],
        ],
    ]),
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer $apiKey",
        "Content-Type: application/json",
    ],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

Python-voorbeeld

import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://verdmarket.com.mature-black-wombat.65-108-70-81.cpanel.site/api/v1/supplier"
headers = {"Authorization": f"Bearer {API_KEY}"}

# List products
resp = requests.get(f"{BASE_URL}/products", headers=headers,
                    params={"page": 1, "per_page": 10})
products = resp.json()

# Bulk stock update
resp = requests.post(f"{BASE_URL}/stock", headers=headers,
                     json={"items": [
                         {"sku": "ROSE-RED-001", "stock_qty": 500},
                         {"sku": "LILY-WHT-003", "stock_qty": 200},
                     ]})
result = resp.json()

# Update order status
resp = requests.post(f"{BASE_URL}/orders/15/status", headers=headers,
                     json={"status": "confirmed",
                           "comment": "Ready for shipment"})
print(resp.json())

Verdmarket Leveranciers-API

Basis-URL

Beschikbare eindpunten

Authenticatie

Snelheidslimieten

Antwoordformaat

Producten

Queryparameters

Voorbeeldantwoord

Verzoekbody (JSON)

Productafbeeldingen

Voorbeeldantwoord

Verzoekbody (JSON)

Verzoekbody

Bulk-voorraadupdate

Verzoekbody

Antwoord

Bulk-prijsupdate

Verzoekbody

Bestellingen

Queryparameters

Verzoekbody

Categorieën

Voorbeeldantwoord

Foutcodes

Codevoorbeelden

Producten weergeven

Product aanmaken

Productafbeeldingen toevoegen

Bulk-voorraadupdate

PHP-voorbeeld

Python-voorbeeld

Cookie-instellingen

Aanpassen