# MerchandAise API i ugovori o integraciji | MerchandAise

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

Istražite MerchandAise ugovore za alate pomoćnika, ugrađene sadržaje zajednice, operacije dobavljača i korporativni identitet, s jasnim granicama javnog i zaštićenog pristupa.

## Zadržite jedan izvor istine
Integracija bi trebala proširiti tijek rada MerchandAise, a ne ga račvati. Web-lokacija, ugrađeni sadržaj, dobavljač, poduzeće i buduće površine pomoćnika moraju čitati i ažurirati isti verzirani dizajn, komercijalnu namjeru, ponudu, odobrenje i stanje narudžbe.
Gdje MerchandAise obrađuje kupčevu transakciju, Hutter Products GmbH je ugovorni prodavatelj i trgovac zapisničar pod robnom markom MerchandAise. Identitet dobavljača i podaci za kontakt ostaju privatni, osim u slučajevima kada je obavezno otkrivanje, a za proizvodnju je i dalje potrebno odobrenje digitalnog probnog otiska i izvornog uzorka.

## API i površine integracije
- **Dokumentacija alata pomoćnika API:** Istražite trenutne krajnje točke alata i pomoćnika za sesije dizajna i pregled integracije. Ova javna referenca ne daje anonimne ovlasti za davanje ponuda ili naručivanje. Human guide: Otvorite dokumentaciju alata pomoćnika (/hr/developers/api-integrations). Machine-readable contract: Alati pomoćnika OpenAPI JSON (/api/docs/openapi.json). Access: public. Javna referenca za API alata i pomoćnika. Pristup proizvodnji i operacije koje utječu na narudžbu i dalje zahtijevaju primjenjivo ovlaštenje. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#api-docs.
- **Ugrađivanje zajednice API:** Povežite lokalizirana iskustva kluba, zajednice ili trgovine s prijenosima dizajna i trgovine u vlasništvu MerchandAise bez ponovne izgradnje temeljnog tijeka rada. Human guide: Pregledajte vodič za integraciju zajednice (/hr/developers/api-integrations#community-integrations). Machine-readable contract: Zajednica OpenAPI JSON (/api/v1/community/public/openapi/v1). Access: public. Javni verzirani ugovor za ugrađene elemente trgovine, otkrivanje zajednice i prijenose prilagođene lokalu. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#community-integrations.
- **Dobavljač API:** Povežite odobrene dobavljače s operacijama uvođenja, kataloga, ponuda i ispunjenja nakon što se odnos s dobavljačem i model pristupa kvalificiraju. Human guide: Pregledajte vodič za integraciju dobavljača (/hr/developers/api-integrations#supplier-integrations). Machine-readable contract: Dobavljač OpenAPI JSON (/api/v1/supplier/openapi/v1). Access: public. Javni ugovor za planiranje i generiranje klijenata. Operativni pristup dobavljača ostaje dozvoljen. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#supplier-integrations.
- **Korporativni identitet API:** Planirajte SSO, SCIM proviziju i tokove identiteta spremne za reviziju za odobrene programe robne marke tvrtke i upravljana uvođenja. Human guide: Pregledajte vodič za korporativnu integraciju (/hr/developers/api-integrations#enterprise-integrations). Machine-readable contract: Korporativni identitet OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). Access: protected. Zaštićeni ugovor za odobrene poslovne radne prostore; zatražite pristup prije korištenja ove krajnje točke. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#enterprise-integrations.

## Odaberite ugovor prije koda
- **Step 1: Mapirajte korisničko putovanje:** Odlučite tko ulazi u tijek rada i gdje: kupac u ugrađenoj trgovini, odobreni dobavljač, korporativni korisnik ili pomoćnik koji radi s izričitim ovlaštenjem.
- **Step 2: Potvrdite granicu pristupa:** Upotrijebite javne ugovore za procjenu i generiranje klijenata, a zatim potvrdite vjerodajnice, opsege, okruženja, povratne pozive i zaštićene krajnje točke prije implementacije.
- **Step 3: Dokazujte kontinuitet stanja:** Testirajte ostaju li dizajni, ponude, odobrenja, pogreške i prijenosi narudžbi usklađeni s verzijama u cijeloj integraciji, uključujući ponovne pokušaje i puteve vraćanja na prethodnu verziju.

## Što svaka integracija mora očuvati
- **Jedno verzirano stanje:** Dizajn, komercijalna namjera, ponuda podržana od dobavljača, odobrenje i status narudžbe ostaju povezani. Zastarjele promjene moraju potaknuti vidljivu ponovnu ponudu ili stanje pregleda.
- **Komercijalna i privatnost dobavljača:** MerchandAise ostaje trgovac okrenut kupcu i vlasnik podrške. Identiteti dobavljača, kontakti i interni podaci nisu izloženi kroz javne integracije.
- **Odobrenje prije proizvodnje:** Prikaz 3D prilagođen proizvodu i digitalni dokaz podržavaju odluku, ali ne zamjenjuju izvorni proizvodni uzorak potreban prije masovne proizvodnje.

## Prije produkcijskog prometa
Objavljena OpenAPI datoteka površina je za planiranje, a ne obećanje anonimnog pristupa proizvodnji. Prije pokretanja pregledavamo okruženja, vjerodajnice, upravljanje neuspjesima i operativno vlasništvo.
- **Pristup i okruženja:** Potvrdite verziju ugovora, odobreni radni prostor, opsege provjere autentičnosti, sandbox, produkcijske vjerodajnice i odredišta povratnih poziva.
- **Neuspjeh i oporavak:** Prije izdanja definirajte ponovne pokušaje, idempotentnost, vremenska ograničenja, pogreške vidljive kupcu, opservabilnost, vlasništvo podrške i povratak na prethodnu verziju.
- **Dokazi od kraja do kraja:** Provjerite namjeravano putovanje u pripremnoj okolini od ulaza i mutacije stanja kroz ponudu, odobrenje, prijenos i ponašanje pri oporavku.

## Česta pitanja
- **S kojom površinom integracije trebam početi?:** Započnite s osobom i prijelazom stanja. Upotrijebite ugrađivanje u zajednicu za putovanja kluba ili zajednice usmjerena na kupca, operacije dobavljača za odobrene radne tokove na strani opskrbe, korporativni identitet za SSO i SCIM, a alate pomoćnika samo za izričito odobrene tokove koje vodi AI.
- **Znači li javni ugovor javni pristup proizvodnji?:** Ne. Javni OpenAPI ugovor podržava otkrivanje, pregled arhitekture i generiranje klijenata. Produkcijske vjerodajnice, operacije pisanja, radni procesi dobavljača, korporativni identitet i izvršenje pomoćnika još uvijek mogu zahtijevati odobreni radni prostor i ovlaštenje s ograničenim opsegom.
- **Može li integracija izložiti dobavljače ili zaobići odobrenja?:** Ne. Identitet dobavljača i podaci za kontakt ostaju privatni, osim u slučajevima kada je obavezno otkrivanje, MerchandAise posjeduje odnos s kupcem, a radnje koje utječu na narudžbu moraju sačuvati konfigurirano odobrenje i vrata izvornog uzorka.

## Donesite nam tijek rada, a ne gotovu arhitekturu.
Recite nam tko će koristiti integraciju, koje stanje trebaju pročitati ili promijeniti i gdje će iskustvo živjeti. S vama ćemo mapirati ugovor, model pristupa i najsigurniji put uvođenja.
- **Planirajte integraciju:** /hr/contact?intent=api-integration-review
- **Istražite AI agente i MCP:** /hr/developers/ai-agents-mcp