Toegang en API-sleutels

Verbind uw applicatie met uw eigen klantbedrijf.

Wilt u assortiment aanleveren? Volg de leveranciershandleiding; die gebruikt een toegewezen feedgeheim.

Toegang voor inkopen

Gebruik uw Producthandel-account en voltooi de bedrijfsverificatie. Klant-API-toegang vereist Scaler of Expert en toelating van uw koppeling. Uw bedrijf, pakket en beschikbare scopes bepalen welke handelingen mogelijk zijn.

Uw applicatie gebruikt Authorization: Bearer <sleutel>. Bewaar de sleutel beveiligd. Zet hem nooit in een URL, browsercode, log of gedeeld voorbeeld.

Een sleutel aanmaken en beheren

Deze routes gebruiken de bestaande beveiligde klantsessie. Ze zijn niet anoniem bereikbaar; een Bearer-sleutel alleen geeft geen toegang tot dit sleutelbeheer. Wijzigingen vereisen ook de bestaande Origin- en CSRF-controle van de klantsessie.

Lees GET /browser/v1/api-keys vanuit de bevoegde klantsessie. Bekijk de huidige beheeropties en beschikbare scopes.
Maak een sleutel via POST /browser/v1/api-keys, met een herkenbaar label, minimale scopes, de teruggegeven accountreferentie en één Idempotency-Key.
Sla de eenmalig getoonde geheime waarde direct op in uw beveiligde sleutelbeheerder.
Is de reactie verloren gegaan? Lees GET /browser/v1/api-key-requests/{request_key} met de oorspronkelijke aanvraagreferentie. Maak niet blind een tweede sleutel. Een hersteld aanvraagrecord betekent niet dat de geheime waarde opnieuw zichtbaar wordt.
Trek een ongebruikte of gecompromitteerde sleutel in via POST /browser/v1/api-keys/{key_id}/revoke, met de vereiste klantsessie, CSRF en idempotency-header. Vervang de sleutel bewust en werk uw applicatie bij.

Kies alleen wat u nodig hebt

Vraag uitsluitend scopes aan die uw account beschikbaar stelt. Bij gebruik blijven intrekking, bedrijfstoegang, pakket en bevoegdheden per handeling gecontroleerd.

Na een fout of time-out

Bewaar de exacte aanvraag en de oorspronkelijke Idempotency-Key per bedoelde opdracht. Lees na een time-out eerst de bewaarde uitkomst. Een andere sleutel kan een tweede opdracht starten. Herhaal een onzekere betaling, acceptatie of retouraanvraag niet blind.

401 / 403: controleer de sleutel, bedrijfstoegang en vereiste scopes.
409: lees de actuele toestand en los het verschil op.
429: respecteer de limiet en een eventuele Retry-After.
503: de koppeling of toelating van transacties kan tijdelijk ontbreken.

Het klantcontract

/public/v1/openapi.json

De volledige referentie beschrijft de inkoop- en leverancierskoppelingen. Deze handleiding gaat over de Bearer-sleutel voor inkopen; leveranciersfeeds gebruiken een afzonderlijke HMAC-sleutel. Het sleutelbeheer hierboven gebruikt de beveiligde klantsessie en valt buiten dit transactieschema. Het schema lezen activeert geen API-toegang of aankoop.

Gebaseerd op het vastgelegde Bridge-contract. Controleer bij integratie altijd de actuele referentie en toegangsvoorwaarden.