Catalogusreferenties

Zoek bestaande catalogusverwijzingen op vóór het importeren. Alle resultaten behoren tot het veilinghuis van de API-sleutel.

Alle lijsten gebruiken limit en cursor. Makers ondersteunen een exact slug-filter en active=true|false; zonder statusfilter verschijnen beide statussen. Een maker bevat type, active, naam, korte omschrijving en omschrijving. Bezorgklassen bevatten naam, omschrijving en position; de volgorde is positie, daarna publieke UUID. Dit zijn instructies zoals “alleen afhalen”, geen verzendtarieven voor de checkout.

Tekst komt uitsluitend uit de standaardtaal van het veilinghuis. Ontbrekende tekst is null, zonder terugval op een andere taal. De nieuwe detailroutes voor makers en bezorgklassen accepteren de ID met prefix of de kale UUID, ook met hoofdletters in de UUID. Onbekende filters, uitbreidingen en ongeldige waarden geven 400; een ID uit een ander veilinghuis of met een verkeerd prefix geeft 404. Een bestaand record zonder geldige publieke identiteit geeft een 500-probleemantwoord.

curl "$BIDVISE_API/api/v2/makers?slug=example-workshop&active=true" \
  -H "Authorization: Bearer $BIDVISE_API_KEY"

curl "$BIDVISE_API/api/v2/delivery_classes?limit=100" \
  -H "Authorization: Bearer $BIDVISE_API_KEY"

Bestaande makers en bezorgklassen zijn te koppelen via items schrijven. De referentierecords zelf aanmaken of wijzigen valt buiten deze leesroutes. Eerdere conceptdocumentatie noemde bezorgklassen shipping_classes; die route is nooit geïmplementeerd. Gebruik delivery_classes. Verzendmethoden met tarieven en aangepaste velden blijven gepland.

Voorbeelden van geretourneerde identiteiten: mkr_2d9f6b31-8e4a-4c05-b7d2-9a1e3f8c6047 en dlc_b48e0a19-5c72-4d83-91af-3e6b2c07d514. Gebruik in detailverzoeken de werkelijke ID uit het antwoord voor het eigen veilinghuis.

Biedstappen

GET /increment_strategies en GET /increment_strategies/{id} geven bestaande biedstapconfiguraties met inc_-identiteiten terug. Hiervoor is bidding_step_configurations.read nodig, hetzelfde recht als voor biedstappen in de backoffice. Alleen lots.read of auctions.read is niet voldoende.

De lijst ondersteunt limit, cursor en een exact, hoofdlettergevoelig name-filter. Namen zijn niet noodzakelijk uniek: vergelijk alle resultaten en bewaar de geretourneerde ID. De volgorde is aanmaaktijd, daarna publieke UUID. Verwijderde configuraties ontbreken. Detail accepteert een ID met prefix of kale UUID, ook met hoofdletters in de UUID. Een buitenlandse, verwijderde of verkeerde soort ID geeft 404. Namen zijn rechtstreeks opgeslagen, zonder vertalingen.

curl --get "$BIDVISE_API/api/v2/increment_strategies" \
  --data-urlencode "name=Default" \
  -H "Authorization: Bearer $BIDVISE_API_KEY"

Een configuratie bevat id, name, geordende steps, created_at en updated_at. Elke stap heeft until en step_size, beide Money-objecten in de kleinste munteenheid van het veilinghuis:

{ "until": { "amount": 10000, "currency": "EUR" },
  "step_size": { "amount": 500, "currency": "EUR" } }

Dit betekent stappen van €5 tot en met €100. Een bereik begint boven de vorige until (nul voor het eerste bereik). Het antwoord beschrijft de opgeslagen biedstappen; het berekent niet het volgende toegestane bod op een kavel. Deze routes maken geen configuraties aan en koppelen ze niet aan sessies. Sessies schrijven blijft gepland.

Voorbeeldidentiteit: inc_2d9f6b31-8e4a-4c05-b7d2-9a1e3f8c6047. Gebruik de ID uit het antwoord voor het eigen veilinghuis.

Bestaande consignaties

GET /consignments en GET /consignments/{id} vereisen seller_profiles.read. Lijsten accepteren exacte filters reference en seller (met ID), plus limit en cursor; de volgorde is aanmaaktijd, daarna UUID. Verwijderde consignaties ontbreken. Elk resultaat bevat de con_-ID, referentie, inbrenger, optionele veiling, locked en tijdstempels. Opmerkingen, commissieafspraken en contactgegevens ontbreken. Een niet-beschikbare inbrenger of veiling geeft null.

Voorbeeld-ID: con_2d9f6b31-8e4a-4c05-b7d2-9a1e3f8c6047. Gebruik de geretourneerde ID van het eigen huis bij items schrijven. Consignaties aanmaken, afspraken wijzigen of vergrendelen/ontgrendelen kan nog niet via v2.