{"pageKey":"Developers","slug":"developers-api-integrations","locale":"hr","localeResolved":"hr","fallbackApplied":false,"version":"developers-api-integrations@2026-11-19T13:03:09.144Z","lastModified":null,"canonicalUrl":"https://www.merchandaise.com/hr/developers/api-integrations","payload":{"slug":"developers-api-integrations","purpose":"llm-developers-api-integrations","title":"API dokumentacija i OpenAPI integracije za proizvode | MerchandAise","description":"Istražite API dokumentaciju i OpenAPI specifikacije MerchandAisea za proizvode po mjeri, ugrađene zajednice, rad dobavljača i poslovni identitet.","sections":[{"heading":"Odaberite vezu koju vaš projekt treba","paragraphs":["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."]},{"heading":"API i integracijska sučelja","items":[{"title":"API dokumentacija i OpenAPI","description":"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."},{"title":"API za zajednice","description":"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."},{"title":"API za dobavljače","description":"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."},{"title":"API za poslovni identitet","description":"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."}]},{"heading":"Odaberite ugovor prije koda","items":[{"title":"Korak 1: Mapirajte korisnički put","description":"Odredite tko i gdje ulazi u postupak: kupac u ugrađenoj trgovini, odobreni dobavljač, poslovni korisnik ili asistent s izričitom autorizacijom."},{"title":"Korak 2: Potvrdite granicu pristupa","description":"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."},{"title":"Korak 3: Dokažite kontinuitet stanja","description":"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."}]},{"heading":"Što svaka integracija mora očuvati","items":[{"title":"Jedno verzionirano stanje","description":"Dizajn, namjera kupnje, ponuda koju podupire dobavljač, odobrenje i status narudžbe ostaju povezani. Zastarjele promjene moraju izazvati vidljivu novu ponudu ili stanje pregleda."},{"title":"Komercijalna privatnost i privatnost dobavljača","description":"MerchandAise ostaje trgovac i nositelj podrške prema kupcu. Identiteti dobavljača, kontakti i interni podatci ne otkrivaju se kroz javne integracije."},{"title":"Odobrenje prije proizvodnje","description":"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."}]},{"heading":"Prije produkcijskog prometa","paragraphs":["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."],"items":[{"title":"Pristup i okruženja","description":"Potvrdite verziju ugovora, odobreni radni prostor, opsege autentifikacije, testno okruženje, produkcijske vjerodajnice i povratna odredišta."},{"title":"Pogreške i oporavak","description":"Prije objave definirajte ponovne pokušaje, idempotentnost, vremenska ograničenja, pogreške vidljive kupcu, nadzor, odgovornost podrške i povratak na prethodno stanje."},{"title":"Dokazi cijelog postupka","description":"U testnom okruženju provjerite željeni put od ulaska i promjene stanja kroz ponudu, odobrenje, predaju i ponašanje pri oporavku."}]},{"heading":"Česta pitanja","items":[{"title":"S kojim API-jem za proizvode trebam početi?","description":"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."},{"title":"Znači li javni ugovor i javni produkcijski pristup?","description":"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."},{"title":"Može li integracija otkriti dobavljače ili zaobići odobrenja?","description":"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."}]},{"heading":"Isplanirajte integraciju s nama.","paragraphs":["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."],"items":[{"title":"Isplanirajte integraciju","description":"/hr/contact?intent=api-integration-review"},{"title":"Istražite AI agente i MCP","description":"/hr/developers/ai-agents-mcp"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"route-owned-source","schema":"2025-11-05"}}