Razvojna platforma MerchandAisea
Povežite svoj radni proces s MerchandAiseom.
Pronađite API dokumentaciju i OpenAPI specifikacije za proizvode po mjeri. Povežite web-stranice, zajednice, rad dobavljača ili poslovne račune sa zajedničkim podatcima o dizajnu, ponudama i narudžbama.
Odaberite vezu koju vaš projekt treba
Referencama u nastavku procijenite krajnje točke, formate zahtjeva i zahtjeve autorizacije. Javne specifikacije podržavaju planiranje i generiranje klijenata; operativni pristup ovisi o API-ju, računu i okruženju.
Kad MerchandAise obrađuje transakciju kupca, Hutter Products GmbH ugovorni je prodavatelj i službeni trgovac pod brendom MerchandAise. Identitet i kontakti dobavljača ostaju privatni osim kad je otkrivanje obvezno, a proizvodnja i dalje zahtijeva odobrenje digitalnog probnog prikaza, potvrđenu izvedivost proizvodnje, obvezne tehničke provjere i odobrenja uzoraka primjenjiva na točnu prihvaćenu narudžbu.
01 — Ugovori
API i integracijska sučelja
01
API dokumentacija i OpenAPI
Pronađite API referencu za alate asistenata i dizajnerske sesije, a zatim odaberite ugovor za zajednice, dobavljače ili poslovne korisnike prema svom postupku.
Vodič za implementaciju
Pročitajte dokumentaciju alata asistenataStrojni ugovor
OpenAPI JSON za alate asistenata/api/docs/openapi.jsonJavna referenca za API-je asistenata i alata. Produkcijski pristup i radnje koje utječu na narudžbu i dalje zahtijevaju odgovarajuću autorizaciju.
02
API za zajednice
Povežite stranicu kluba ili zajednice s javnim informacijama zajednice, objavama dizajna, glasovanjem i prijelazima za odobravanje narudžbi.
- Što ugovor obuhvaća
- Javni kontekst zajednice, objave dizajna i glasove, objavu ponude, narudžbe na čekanju te odobrenje ili odbijanje vlasnika zajednice.
- Praktična početna točka
- Pročitajte javni kontekst zajednice za klupsku stranicu. Zatim utvrdite koje radnje zahtijevaju člansku sesiju ili ovlasti vlasnika prije dodavanja objava dizajna ili prijelaza u kupnju.
- Pristup
- Specifikacija je javna. Javna čitanja, članske radnje i radnje vlasnika imaju različite zahtjeve autorizacije; slijedite sigurnosna pravila svake krajnje točke.
Strojni ugovor
OpenAPI JSON za zajednice/api/v1/community/public/openapi/v1Javni verzionirani ugovor za ugrađene trgovine, otkrivanje zajednica i prijelaze prilagođene jeziku.
03
API za dobavljače
Povežite odobrene dobavljačke sustave s izdanim proizvodnim paketima, statusom prijave te ERP ili PLM postupcima web-dojavnika.
- Što ugovor obuhvaća
- Status prijave dobavljača, izdani proizvodni paketi, evidentirana preuzimanja datoteka, analitika, pretplate na web-dojavnike i kontrolne točke sinkronizacije.
- Praktična početna točka
- Isplanirajte vezu između ERP sustava ili sustava upravljanja životnim ciklusom proizvoda i Centra za dobavljače. Pregledajte sadržaj web-dojavnika, ponovne pokušaje i status sinkronizacije prije obrade dodijeljene narudžbe.
- Pristup
- Pročitajte OpenAPI specifikaciju bez prijave. Operativni zahtjevi traže odgovarajući račun dobavljača i ovlasti; javna dokumentacija ne upisuje dobavljača niti daje pristup podatcima drugog dobavljača.
Strojni ugovor
OpenAPI JSON za dobavljače/api/v1/supplier/openapi/v1Javni ugovor za planiranje i generiranje klijenata. Operativni pristup dobavljača i dalje je ograničen ovlastima.
04
API za poslovni identitet
Povežite odobrene poslovne radne prostore s jedinstvenom prijavom, pripremom korisnika i grupa te revizijskim zapisima identiteta.
- Što ugovor obuhvaća
- Jedinstvena prijava OpenID Connect (OIDC), SCIM upravljanje životnim ciklusom korisnika i grupa, rotacija SCIM tokena i revizijski događaji pripreme računa.
- Praktična početna točka
- Povežite davatelja identiteta s odobrenim radnim prostorom. Isplanirajte prijavu, dodavanje i uklanjanje korisničkih pristupa, a zatim provjerite mapiranje grupa i revizijske zapise u dogovorenom testnom okruženju.
- Pristup
- Specifikacija poslovnog identiteta je zaštićena. Prije implementacije kontaktirajte tim za integracije radi pregleda radnog prostora i zahtjeva pristupa. Poslovni identitet nije obvezan za uobičajene kupnje proizvoda.
Strojni ugovor
OpenAPI JSON za poslovni identitet/api/v1/enterprise/identity/openapi/v1Zaštićeni ugovor za odobrene poslovne radne prostore; zatražite pristup prije korištenja ove krajnje točke.
Isplanirajte integraciju02 — Vodič za implementaciju
Odaberite ugovor prije koda
- 01
Mapirajte korisnički put
Odredite tko i gdje ulazi u postupak: kupac u ugrađenoj trgovini, odobreni dobavljač, poslovni korisnik ili asistent s izričitom autorizacijom.
- 02
Potvrdite granicu pristupa
Koristite javne ugovore za procjenu i generiranje klijenata, a zatim prije implementacije potvrdite vjerodajnice, opsege ovlasti, okruženja, povratne adrese i zaštićene krajnje točke.
- 03
Dokažite kontinuitet stanja
Provjerite ostaju li dizajni, ponude, odobrenja, pogreške i prijelazi narudžbi na aktualnoj verziji kroz integraciju, uključujući ponovne pokušaje i putove povratka.
03 — Što svaka integracija mora očuvati
Što svaka integracija mora očuvati
Jedno verzionirano stanje
Dizajn, namjera kupnje, ponuda koju podupire dobavljač, odobrenje i status narudžbe ostaju povezani. Zastarjele promjene moraju izazvati vidljivu novu ponudu ili stanje pregleda.
Komercijalna privatnost i privatnost dobavljača
MerchandAise ostaje trgovac i nositelj podrške prema kupcu. Identiteti dobavljača, kontakti i interni podatci ne otkrivaju se kroz javne integracije.
Odobrenje prije proizvodnje
3D prikaz nije fizički dokaz. Potvrđena ponuda navodi dostupne mogućnosti uzoraka za kupca, troškove, ograničenja i rokove. Prije serijske proizvodnje odobrite točan digitalni probni prikaz te dovršite obvezne tehničke provjere i svako obvezno ili odabrano odobrenje uzorka. Zahtjevi već prihvaćene narudžbe ostaju obvezujući.
04
Prije produkcijskog prometa
Objavljena OpenAPI datoteka služi planiranju, a ne obećanju anonimnog produkcijskog pristupa. Prije pokretanja pregledavamo okruženja, vjerodajnice, obradu pogrešaka i operativnu odgovornost.
Pristup i okruženja
Potvrdite verziju ugovora, odobreni radni prostor, opsege autentifikacije, testno okruženje, produkcijske vjerodajnice i povratna odredišta.
Pogreške i oporavak
Prije objave definirajte ponovne pokušaje, idempotentnost, vremenska ograničenja, pogreške vidljive kupcu, nadzor, odgovornost podrške i povratak na prethodno stanje.
Dokazi cijelog postupka
U testnom okruženju provjerite željeni put od ulaska i promjene stanja kroz ponudu, odobrenje, predaju i ponašanje pri oporavku.
Česta pitanja
S kojim API-jem za proizvode trebam početi?
Počnite s osobom i promjenom stanja. Koristite ugrađene zajednice za klupske ili zajedničke korisničke putove, dobavljačke radnje za odobrene postupke ponude, poslovni identitet za SSO i SCIM, a alate asistenata samo za izričito autorizirane AI postupke.
Znači li javni ugovor i javni produkcijski pristup?
Ne. Javni OpenAPI ugovor podržava otkrivanje, pregled arhitekture i generiranje klijenata. Produkcijske vjerodajnice, upisi, dobavljački postupci, poslovni identitet i izvršavanje asistenata i dalje mogu zahtijevati odobreni radni prostor i ograničenu autorizaciju.
Može li integracija otkriti dobavljače ili zaobići odobrenja?
Ne. Identitet i kontakti dobavljača ostaju privatni osim kad je otkrivanje obvezno, MerchandAise vodi odnos s kupcem, a radnje koje utječu na narudžbu moraju očuvati konfigurirane zahtjeve odobrenja digitalnog probnog prikaza, tehničkih provjera i uzoraka za konkretnu narudžbu.
Isplanirajte integraciju s nama.
Recite nam tko će koristiti integraciju, koje stanje treba čitati ili mijenjati i gdje će iskustvo biti dostupno. Zajedno ćemo odrediti ugovor, model pristupa i najsigurniji put pokretanja.