01
De collectie importeren
In Postman: File → Import → Link. Plak de JSON-URL via de downloadknop hierboven. Postman voegt de collectie — inclusief de variabelen — toe aan je werkruimte.
Ontwikkelaars · Postman-collectie
Importeer de collectie. In vijf minuten op de API.
Een kant-en-klare Postman-collectie met uitgewerkte voorbeelden voor de Fabrixa Integration API. Voer je inloggegevens in, klik de verzoeken door en bekijk echte responses van de API voordat je ook maar één regel integratiecode schrijft. De collectie wordt bijgehouden over verschillende versies heen — de collectie wordt bijgewerkt wanneer de API wordt bijgewerkt.
Wat zit er in de collectie?
Elk endpoint, met voorbeeldpayloads.
Geordend in mappen per resource. Elk verzoek wordt geleverd met een uitgewerkt voorbeeld van de body, de twee authenticatieheaders die al zijn ingesteld, en een opgeslagen voorbeeld van het antwoord — zodat je de structuur van het antwoord kunt bekijken voordat je het verzoek verstuurt.
Auth & producten
- GET /ping — inloggegevens controleren
- GET /products — lijst & paginering (SKU + variant_id)
- Volledige veldschema’s in de Swagger-referentie
Bestellingen
- POST /orders — een bestelling aanmaken
- GET /orders/{id}/fulfillments — productie volgen
Studio & webhooks
- GET /v2/studio/customizations/{key}/preview
- Webhook-payload + HMAC-verificatie (voorbeeld)
Importeren in 30 seconden
File → Import → Link → URL plakken.
02
Open het tabblad ‘Variabelen’
De collectie wordt geleverd met eigen variabelen — base_url is vooraf ingevuld; access_token en application_key zijn tijdelijke aanduidingen. Er is geen apart omgevingsbestand nodig.
03
Plak je sleutels hier
Voer het applicatietoegangstoken en de applicatiesleutel van een verkoopkanaal in op je dashboard, klik op ‘Opslaan’ en elk verzoek wordt geauthenticeerd.
Omgevingsvariabelen
Wat er in het env-bestand staat.
Eén basis-URL, twee inloggegevens, ingebouwd in de collectie. Bouw de collectie op basis van één verkoopkanaal en plak vervolgens de sleutels van je live kanaal wanneer je de collectie live zet — dezelfde collectie, dezelfde verzoeken.
Collectievariabelen
{
"base_url": "https://api.fabrixa.com/v2/integration",
"studio_base": "https://api.fabrixa.com/v2/studio",
"access_token": "APPLICATION_ACCESS_TOKEN",
"application_key": "APPLICATION_KEY"
}
Auth is vooraf geconfigureerd
Beide authenticatie-headers worden bij elk verzoek standaard ingesteld.
Elk verzoek houdt in dat Authorization: Bearer {{access_token}} en X-Application-Key: {{application_key}}, afkomstig uit de collectievariabelen — geen instelling van headers per verzoek. Om van het ene verkoopkanaal naar het andere over te schakelen, hoef je alleen maar die twee variabelen aan te passen: dezelfde collectie, andere sleutels.
Voorbeelden met uitwerkingen
Elk verzoek wordt geleverd met een voorbeeld body en opgeslagen antwoord.
De collectie bestaat niet alleen uit URL-stubs — elk verzoek bevat een uitgewerkte voorbeeld-body, zodat je op ‘Verzenden’ kunt klikken en echte gegevens kunt zien. Opgeslagen voorbeeldantwoorden worden in het paneel ‘Voorbeelden’ bewaard, zodat je ze offline kunt raadplegen.
Authenticatie controleren
Controleert allereerst of je applicatietoegangstoken en applicatiesleutel geldig zijn. 200 bij succes, 401 als er een header ontbreekt.
Producten weergeven
Verzoek om een gepagineerde catalogus. Geeft de producten pagina voor pagina weer in de links / meta / data-envelop, met SKU en het variant-ID per artikel.
Een bestelling plaatsen
Voorbeeld-body voor een bestelling van één T-shirt, inclusief bron-PDF, klantgegevens en verzendadres. Klik op ‘Verzenden’ om de aangemaakte bestelling met het Fabrixa-ID te bekijken.
Productie bijhouden
Geeft de productiestappen per artikel weer (bedrukken, fixeren, wassen, naaien) met de statussen pending / in progress / done / rejected voor een geplaatste bestelling.
Studio-preview
Geeft de weergegeven voorbeeldafbeelding weer voor een opgeslagen Studio-aanpassing — plaats deze direct in een miniatuurafbeelding van het winkelmandje.
Controle van de handtekening
Een uitgewerkt voorbeeld van het opnieuw berekenen van de HMAC-SHA256-handtekening en het vergelijken daarvan met de x-webhook-signature vóór de verwerking.
Versiebeheer
De collectie wordt bijgewerkt wanneer de API dat doet.
Bij elke API-release wordt een bijgewerkte verzameling onder dezelfde URL gepubliceerd. Importeer de gegevens opnieuw om nieuwe endpoints en voorbeeldpayloads op te halen — bestaande verzoeken in je opgeslagen versie blijven werken totdat dat endpoint daadwerkelijk wordt afgeschaft.
Vaste URL
De JSON-URL van de collectie is permanent. Bij het opnieuw importeren wordt de nieuwste versie opgehaald — de URL verandert nooit tussen releases.
Changelog-referentie
Zie de changelog voor de bijpassende API-versienotities - wat is verplaatst, wat is toegevoegd, wat wordt uitgefaseerd.
Beleid inzake het uitfaseren van functies
Voor endpoints geldt een overgangsperiode van 12 maanden. De collectie markeert verouderde verzoeken in de beschrijving, zodat ze moeilijk over het hoofd te zien zijn voordat er iets misgaat.
Downloaden en starten
Pak de collectie. Vuur je eerste verzoek af.
Importeer de collectie, voer de inloggegevens van je verkoopkanaal in en verstuur je eerste verzoek binnen enkele minuten — je hebt geen integratiecode nodig om aan de slag te gaan.