Sari la conținutul principal

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.

Acces: Public/api/docs/openapi.json

Referință 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.
Acces: Public

Contract pentru sisteme

JSON OpenAPI pentru comunități
/api/v1/community/public/openapi/v1

Contract 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.
Acces: Public

Contract pentru sisteme

JSON OpenAPI pentru furnizori
/api/v1/supplier/openapi/v1

Contract 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.
Acces: Protejat

Contract pentru sisteme

JSON OpenAPI de identitate pentru companii
/api/v1/enterprise/identity/openapi/v1

Contract protejat pentru spațiile de lucru aprobate ale companiilor; solicită acces înainte de a folosi acest endpoint.

Planifică o integrare

02 — Ghid de implementare

Alege contractul înaintea codului

  1. 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ă.

  2. 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.

  3. 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.

01

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.

02

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.

03

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.