Platforma pentru dezvoltatori MerchandAise
Conectează procesul tău la MerchandAise.
Găsește documentația API și specificațiile OpenAPI pentru produse personalizate. Conectează site-uri, comunități, operațiuni ale furnizorilor sau conturi de companie la informațiile comune de design, ofertă și comandă.
Alege conexiunea de care are nevoie proiectul tău
Folosește referințele de mai jos pentru a evalua endpointurile, formatele cererilor și cerințele de autorizare. Specificațiile publice susțin planificarea și generarea clienților software; accesul operațional depinde de API, cont și mediu.
Când MerchandAise procesează tranzacția cumpărătorului, Hutter Products GmbH este vânzătorul contractual și Merchant of Record sub marca MerchandAise. Identitatea și datele de contact ale furnizorilor rămân private, cu excepția dezvăluirilor impuse, iar producția necesită în continuare aprobarea machetei digitale, fezabilitate confirmată, verificări tehnice obligatorii și aprobările mostrelor aplicabile comenzii exacte acceptate.
01 — Contracte
Interfețe API și de integrare
01
Documentație API și OpenAPI
Găsește referința API pentru instrumentele asistenților și sesiunile de design, apoi alege contractul de comunitate, furnizor sau companie pentru procesul tău.
Ghid de implementare
Citește documentația instrumentelor asistențilorContract pentru sisteme
JSON OpenAPI pentru instrumentele asistenților/api/docs/openapi.jsonReferință publică pentru API-urile asistenților și instrumentelor. Accesul de producție și operațiunile care afectează comenzile necesită în continuare autorizarea aplicabilă.
02
API pentru comunități
Conectează site-ul unui club sau al unei comunități la informațiile publice ale comunității, propunerile de design, voturi și transferurile pentru aprobarea comenzilor.
- Ce acoperă contractul
- Contextul public al comunității, postările de design și voturile, publicarea listărilor, comenzile în așteptare și aprobarea sau respingerea de către proprietarul comunității.
- Un punct practic de plecare
- Citește contextul public al comunității pentru site-ul unui club. Apoi identifică acțiunile care necesită o sesiune de membru sau permisiuni de proprietar, înainte să adaugi propuneri de design sau transferuri către finalizarea comenzii.
- Acces
- Specificația este publică. Citirile publice, acțiunile membrilor și operațiunile rezervate proprietarului au cerințe diferite de autorizare; respectă regulile de securitate ale fiecărui endpoint.
Contract pentru sisteme
JSON OpenAPI pentru comunități/api/v1/community/public/openapi/v1Contract public versionat pentru magazine încorporate, descoperirea comunităților și transferuri care păstrează limba și regiunea.
03
API pentru furnizori
Conectează sistemele furnizorilor aprobați la pachetele de producție eliberate, starea înscrierii și procesele webhook ERP sau PLM.
- Ce acoperă contractul
- Starea înscrierii furnizorilor, pachete de producție eliberate, descărcări de fișiere auditate, analize, abonamente webhook și puncte de sincronizare.
- Un punct practic de plecare
- Planifică o conexiune între sistemul tău ERP sau de gestionare a ciclului de viață al produselor și Centrul furnizorilor. Verifică datele webhook, reîncercările și starea sincronizării înainte de a procesa o comandă atribuită.
- Acces
- Citește specificația OpenAPI fără autentificare. Cererile operaționale necesită contul și permisiunile corespunzătoare de furnizor; documentația publică nu înscrie un furnizor și nu oferă acces la datele altui furnizor.
Contract pentru sisteme
JSON OpenAPI pentru furnizori/api/v1/supplier/openapi/v1Contract public pentru planificare și generarea clienților software. Accesul operațional al furnizorilor rămâne condiționat de permisiuni.
04
API de identitate pentru companii
Conectează spațiile de lucru aprobate ale companiilor la autentificare unică, configurarea utilizatorilor și grupurilor și jurnale de audit al identității.
- Ce acoperă contractul
- Autentificare unică OpenID Connect (OIDC), operațiuni SCIM pentru ciclul de viață al utilizatorilor și grupurilor, rotația tokenurilor SCIM și evenimente de audit ale configurării.
- Un punct practic de plecare
- Conectează furnizorul de identitate la spațiul de lucru aprobat. Planifică autentificarea, crearea și dezactivarea utilizatorilor, apoi verifică mapările grupurilor și jurnalele de audit în mediul de testare convenit.
- Acces
- Specificația de identitate pentru companii este protejată. Contactează echipa de integrări pentru a analiza spațiul de lucru și cerințele de acces înainte de implementare. Identitatea de companie este opțională pentru achizițiile obișnuite de produse.
Contract pentru sisteme
JSON OpenAPI de identitate pentru companii/api/v1/enterprise/identity/openapi/v1Contract protejat pentru spațiile de lucru aprobate ale companiilor; solicită acces înainte de a folosi acest endpoint.
Planifică o integrare02 — Ghid de implementare
Alege contractul înaintea codului
- 01
Definește parcursul utilizatorului
Stabilește cine intră în proces și de unde: un cumpărător într-un magazin încorporat, un furnizor aprobat, un utilizator de companie sau un asistent care operează cu autorizare explicită.
- 02
Confirmă limita accesului
Folosește contractele publice pentru evaluare și generarea clienților software, apoi confirmă datele de acces, domeniile, mediile, callbackurile și endpointurile protejate înainte de implementare.
- 03
Demonstrează continuitatea stării
Testează dacă designurile, ofertele, aprobările, erorile și transferurile comenzilor păstrează versiunea actuală în integrare, inclusiv reîncercările și parcursurile de revenire.
03 — Ce trebuie să păstreze fiecare integrare
Ce trebuie să păstreze fiecare integrare
O singură stare versionată
Designul, intenția comercială, oferta susținută de furnizor, aprobarea și starea comenzii rămân conectate. Modificările bazate pe date învechite trebuie să declanșeze vizibil o ofertă nouă sau o analiză.
Confidențialitate comercială și a furnizorilor
MerchandAise rămâne comerciantul și responsabilul de asistență în relația cu cumpărătorul. Identitățile, contactele și datele interne ale furnizorilor nu sunt expuse prin integrările publice.
Aprobare înainte de producție
O vizualizare 3D nu este o dovadă fizică. Oferta confirmată explică opțiunile disponibile de mostre pentru client, costurile, limitele și termenele. Aprobă macheta digitală exactă și efectuează verificările tehnice obligatorii și aprobarea mostrelor necesare sau alese înainte de producția în serie. Cerințele unei comenzi deja acceptate rămân obligatorii.
04
Înainte de traficul de producție
Un fișier OpenAPI publicat este un instrument de planificare, nu o promisiune de acces anonim în producție. Analizăm mediile, datele de acces, tratarea erorilor și responsabilitatea operațională înainte de lansare.
Acces și medii
Confirmă versiunea contractului, spațiul de lucru aprobat, domeniile de autentificare, mediul de testare, datele de acces în producție și destinațiile callback.
Erori și recuperare
Definește reîncercările, idempotența, timpii de așteptare, erorile vizibile clientului, monitorizarea, responsabilitatea asistenței și revenirea înainte de lansare.
Dovezi pentru întregul parcurs
Verifică parcursul dorit în mediul de testare, de la intrare și modificarea stării la ofertă, aprobare, transfer și recuperare.
Întrebări frecvente
Cu ce API de produse personalizate ar trebui să încep?
Începe cu persoana și schimbarea de stare. Folosește comunitățile încorporate pentru parcursuri de club sau comunitate destinate cumpărătorilor, operațiunile furnizorilor pentru procese aprobate de producție, identitatea companiilor pentru SSO și SCIM și instrumentele asistenților numai pentru procese AI autorizate explicit.
Un contract public înseamnă acces public în producție?
Nu. Un contract OpenAPI public susține descoperirea, analiza arhitecturii și generarea clienților software. Datele de acces în producție, operațiunile de scriere, procesele furnizorilor, identitatea companiilor și execuția asistenților pot necesita în continuare un spațiu de lucru aprobat și autorizare limitată.
O integrare poate expune furnizorii sau ocoli aprobările?
Nu. Identitatea și datele de contact ale furnizorilor rămân private, cu excepția dezvăluirilor impuse, MerchandAise gestionează relația cu cumpărătorul, iar acțiunile care afectează comenzile trebuie să păstreze cerințele configurate de aprobare a machetei digitale, verificare tehnică și mostre specifice comenzii.
Planifică integrarea cu noi.
Spune-ne cine va folosi integrarea, ce stare trebuie să citească sau să modifice și unde va exista experiența. Stabilim împreună contractul, modelul de acces și cel mai sigur parcurs de lansare.