# API dokumentacija i OpenAPI integracije za proizvode | MerchandAise

- slug: developers-api-integrations
- locale: hr
- localeResolved: hr
- canonical: https://www.merchandaise.com/hr/developers/api-integrations

Istražite API dokumentaciju i OpenAPI specifikacije MerchandAisea za proizvode po mjeri, ugrađene zajednice, rad dobavljača i poslovni identitet.

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

## API i integracijska sučelja
- **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 asistenata (/api/docs). Strojno čitljiv ugovor: OpenAPI JSON za alate asistenata (/api/docs/openapi.json). Pristup: Javno. Javna referenca za API-je asistenata i alata. Produkcijski pristup i radnje koje utječu na narudžbu i dalje zahtijevaju odgovarajuću autorizaciju. Kanonska stranica: /hr/developers/api-integrations. Kanonski odjeljak: /hr/developers/api-integrations#api-docs.
- **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. Vodič za implementaciju: Istražite API za zajednice (/hr/developers/api-integrations#community-integrations). Strojno čitljiv ugovor: OpenAPI JSON za zajednice (/api/v1/community/public/openapi/v1). Pristup: Javno. Javni verzionirani ugovor za ugrađene trgovine, otkrivanje zajednica i prijelaze prilagođene jeziku. Kanonska stranica: /hr/developers/api-integrations. Kanonski odjeljak: /hr/developers/api-integrations#community-integrations.
- **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. Vodič za implementaciju: Istražite API za dobavljače (/hr/developers/api-integrations#supplier-integrations). Strojno čitljiv ugovor: OpenAPI JSON za dobavljače (/api/v1/supplier/openapi/v1). Pristup: Javno. Javni ugovor za planiranje i generiranje klijenata. Operativni pristup dobavljača i dalje je ograničen ovlastima. Kanonska stranica: /hr/developers/api-integrations. Kanonski odjeljak: /hr/developers/api-integrations#supplier-integrations.
- **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. Vodič za implementaciju: Istražite poslovni identitet (/hr/developers/api-integrations#enterprise-integrations). Strojno čitljiv ugovor: OpenAPI JSON za poslovni identitet (/api/v1/enterprise/identity/openapi/v1). Pristup: Zaštićeno. Zaštićeni ugovor za odobrene poslovne radne prostore; zatražite pristup prije korištenja ove krajnje točke. Kanonska stranica: /hr/developers/api-integrations. Kanonski odjeljak: /hr/developers/api-integrations#enterprise-integrations.

## Odaberite ugovor prije koda
- **Korak 1: 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.
- **Korak 2: 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.
- **Korak 3: 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.

## Š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.

## 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.
- **Isplanirajte integraciju:** /hr/contact?intent=api-integration-review
- **Istražite AI agente i MCP:** /hr/developers/ai-agents-mcp
