Developers
Van productlink
tot cataloguskoppeling.
Begin met de eenvoudigste integratie die past bij je winkel. Deze documentatie beschrijft de huidige toepassing, inclusief wat nog niet automatisch werkt.
Een AR-knop zonder extra script
Open een product in je madeAr-dashboard en kopieer de publieke link naar de viewer. Controleer of een 3D-model gereed is: zonder model toont die pagina alleen een fotovoorbeeld. Plak de link hieronder en voeg de knopcode toe aan je producttemplate.
Deze link opent een aparte pagina. Er wordt op je webshop geen madeAr-script of 3D-model geladen. Stijl de link met je eigen thema. Een ingesloten viewer kan andere camera- en iframe-beperkingen hebben en wordt hier niet als standaardoplossing aangeboden.
API-toegang
Maak in het dashboard onder Integraties een API-sleutel aan. API-toegang moet voor het bedrijfsaccount actief zijn. Gebruik de sleutel alleen op je server, nooit in HTML of browsercode.
GET /api/v1/products
Authorization: Bearer <JOUW_SERVER_API_SLEUTEL>| Methode | Pad | Functie |
|---|---|---|
| GET / POST | /api/v1/products | Producten lezen / aanmaken |
| GET | /api/v1/products/:id | Product met modelgegevens lezen |
| PATCH | /api/v1/products/:id | Naam, module, categorie en omschrijving bijwerken |
| DELETE | /api/v1/products/:id | Product verwijderen |
| GET | /api/v1/ar-models | Modelstatus en GLB-/USDZ-URL’s lezen |
| GET | /api/v1/analytics?since=<ISO-datum> | Geregistreerde gebeurtenissen per type en module |
De productlijst geeft maximaal 500 regels terug; er is nog geen paginering. De PATCH-route verandert geen foto’s of afmetingen. Er is geen publieke generatie-API, webhookverwerking of automatische webshop-/variantsynchronisatie. Plan een grotere koppeling dus pas na het oplossen van die grenzen.
Een onbekende sleutel geeft 401; ontbrekende accounttoegang kan 403 geven; te veel verzoeken geven 429. Bewaar de publieke product-ID om naar de viewer te linken. Beschikbare modules en verzoeklimieten verschillen per bedrijf.
Generatie en opslag
Productimport slaat foto’s in de bestandsopslag van de toepassing op. Modelrecords kunnen verwijzen naar GLB- en USDZ-bestanden. De demonstratiemodellen worden met de site geleverd.
Nieuwe generatiejobs staan momenteel in een wachtrij zonder aangesloten provider. Automatisch modellen ophalen, definitief opslaan, controleren en publiceren is nog niet geïmplementeerd. We beloven daarom nog geen permanent archief van toekomstige providerresultaten of een werkende wissel tussen providers.
Performance: duidelijk over wat we weten
- De homepage laadt geen 3D-model voor de veranda. Het GLB wordt pas opgevraagd na het derde geldige AR-punt.
- De gewone productviewer laadt het model bij het openen van de viewerpagina.
- De marketingbeelden gebruiken WebP; beelden onder de eerste sectie laden uitgesteld.
- Er is nog geen modeloptimalisatieproces of gepubliceerde Core Web Vitals-meting voor klantwebshops.
Meet modelgrootte, mobiele laadtijd en het effect op jouw webshop voordat je uitrolt. Er wordt geen vaste snelheids- of conversiewinst gegarandeerd.
Apparaten en AR-routes
De drie-puntsdemo gebruikt WebXR op ondersteunde Android-toestellen. De gewone viewer gebruikt model-viewer en kan een andere AR-route kiezen, waaronder Quick Look voor geschikte iPhone-modellen. De drie-puntsworkflow wordt daar niet overgenomen.
Technische achtergrond: model-viewer — augmented reality.
Bekijk beheer & beveiliging →