{"pageKey":"Developers","slug":"developers-api-integrations","locale":"ro","localeResolved":"ro","fallbackApplied":false,"version":"developers-api-integrations@2026-07-21T09:39:17.914Z","lastModified":"2026-07-21T09:39:17.914Z","canonicalUrl":"https://www.merchandaise.com/ro/developers/api-integrations","payload":{"slug":"developers-api-integrations","purpose":"llm-developers-api-integrations","title":"Contracte de integrare și API pentru mărfuri | MerchandAise","description":"Explorați contractele MerchandAise pentru instrumente de asistență, integrări în comunități, operațiuni cu furnizorii și identitate enterprise, cu limite clare de acces public și protejat.","sections":[{"heading":"Păstrați o singură sursă de adevăr","paragraphs":["O integrare ar trebui să extindă fluxul de lucru MerchandAise, nu să îl ramifice. Interfețele pentru site-uri web, integrări, furnizori, enterprise și viitorii asistenți trebuie să citească și să actualizeze aceeași stare versiunată de design, intenție comercială, ofertă, aprobare și comandă.","Acolo unde MerchandAise procesează tranzacția cumpărătorului, Hutter Products GmbH este vânzătorul contractant și Merchant of Record sub marca MerchandAise. Identitatea și datele de contact ale furnizorului rămân private, cu excepția cazurilor în care divulgarea este obligatorie, iar producția necesită în continuare aprobarea bunului de tipar digital și a unei mostre fizice reale."]},{"heading":"Interfețe API și de integrare","items":[{"title":"Documentație API pentru instrumente de asistență","description":"Explorați endpoint-urile actuale pentru asistenți și instrumente pentru sesiuni de design și revizuirea integrării. Această referință publică nu acordă autoritate anonimă de a oferta sau de a plasa o comandă. Human guide: Deschide documentația instrumentelor de asistență (/ro/developers/api-integrations). Machine-readable contract: JSON OpenAPI pentru instrumente de asistență (/api/docs/openapi.json). Access: public. Referință publică pentru API-urile de asistență și instrumente. Accesul în producție și operațiunile care afectează comenzile necesită în continuare autorizarea corespunzătoare. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#api-docs."},{"title":"API pentru integrare în comunități","description":"Conectați experiențe localizate de cluburi, comunități sau magazine la fluxurile de design și finalizare a tranzacțiilor deținute de MerchandAise, fără a reconstrui fluxul de lucru de bază. Human guide: Revizuiți ghidul de integrare în comunități (/ro/developers/api-integrations#community-integrations). Machine-readable contract: JSON OpenAPI pentru comunități (/api/v1/community/public/openapi/v1). Access: public. Contract versiunat public pentru integrări de magazine, descoperire în comunitate și transferuri adaptate la nivel local. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#community-integrations."},{"title":"API pentru furnizori","description":"Conectați furnizorii aprobați la operațiunile de înrolare, catalog, ofertare și onorare, după ce relația cu furnizorul și modelul de acces au fost calificate. Human guide: Revizuiți ghidul de integrare pentru furnizori (/ro/developers/api-integrations#supplier-integrations). Machine-readable contract: JSON OpenAPI pentru furnizori (/api/v1/supplier/openapi/v1). Access: public. Contract public pentru planificare și generare de clienți. Accesul operațional al furnizorilor rămâne condiționat de permisiuni. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#supplier-integrations."},{"title":"API de identitate enterprise","description":"Planificați SSO, provizionarea SCIM și fluxurile de identitate pregătite pentru audit pentru programele aprobate de produse promoționale ale companiei și lansările controlate. Human guide: Revizuiți ghidul de integrare enterprise (/ro/developers/api-integrations#enterprise-integrations). Machine-readable contract: JSON OpenAPI pentru identitate enterprise (/api/v1/enterprise/identity/openapi/v1). Access: protected. Contract protejat pentru spațiile de lucru enterprise aprobate; solicitați accesul înainte de a utiliza acest endpoint. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#enterprise-integrations."}]},{"heading":"Alegeți contractul înainte de cod","items":[{"title":"Step 1: Hartați parcursul utilizatorului","description":"Decideți cine intră în fluxul de lucru și unde: un cumpărător într-un magazin integrat, un furnizor aprobat, un utilizator enterprise sau un asistent care operează cu autorizare explicită."},{"title":"Step 2: Confirmați limita de acces","description":"Utilizați contractele publice pentru evaluare și generarea clienților, apoi confirmați acreditările, permisiunile (scopes), mediile, callback-urile și endpoint-urile protejate înainte de implementare."},{"title":"Step 3: Dovediți continuitatea stării","description":"Testați ca designurile, ofertele, aprobările, erorile și transferurile de comenzi să rămână la zi cu versiunea în cadrul integrării, inclusiv căile de reîncercare și de revenire (rollback)."}]},{"heading":"Ce trebuie să păstreze fiecare integrare","items":[{"title":"O singură stare versiunată","description":"Designul, intenția comercială, oferta susținută de furnizor, aprobarea și starea comenzii rămân conectate. Modificările învechite trebuie să declanșeze o reofertare vizibilă sau o stare de revizuire."},{"title":"Confidențialitatea comercială și a furnizorilor","description":"MerchandAise rămâne comerciantul orientat către cumpărător și proprietarul asistenței. Identitățile, contactele și datele interne ale furnizorilor nu sunt expuse prin integrări publice."},{"title":"Aprobarea înainte de producție","description":"O vizualizare 3D nativă a produsului și bunul de tipar digital susțin decizia, dar nu înlocuiesc mostra fizică reală de producție necesară înainte de producția în masă."}]},{"heading":"Înainte de traficul de producție","paragraphs":["Un fișier OpenAPI publicat este o interfață de planificare, nu o promisiune de acces anonim în producție. Revizuim mediile, acreditările, gestionarea erorilor și responsabilitatea operațională înainte de lansare."],"items":[{"title":"Acces și medii","description":"Confirmați versiunea contractului, spațiul de lucru aprobat, permisiunile de autentificare, mediul sandbox, acreditările de producție și destinațiile de callback."},{"title":"Erori și recuperare","description":"Definiți reîncercările, idenpotența, timpii de expirare (timeouts), erorile vizibile pentru clienți, observabilitatea, responsabilitatea asistenței și revenirea (rollback) înainte de lansare."},{"title":"Dovezi cap-la-cap","description":"Verificați parcursul dorit în mediul de staging, de la intrare și modificarea stării, până la ofertă, aprobare, transfer și comportamentul de recuperare."}]},{"heading":"Întrebări frecvente","items":[{"title":"Cu ce interfață de integrare ar trebui să încep?","description":"Începeți cu utilizatorul și tranziția de stare. Utilizați integrările în comunități pentru parcursuri de club sau comunitate orientate către cumpărători, operațiunile cu furnizorii pentru fluxuri aprobate pe partea de aprovizionare, identitatea enterprise pentru SSO și SCIM, și instrumentele de asistență doar pentru fluxuri ghidate de AI autorizate în mod explicit."},{"title":"Un contract public înseamnă acces public în producție?","description":"Nu. Un contract OpenAPI public sprijină descoperirea, revizuirea arhitecturii și generarea clienților. Acreditările de producție, operațiunile de scriere, fluxurile de lucru ale furnizorilor, identitatea enterprise și execuția asistenților pot necesita în continuare un spațiu de lucru aprobat și o autorizare specifică (scoped)."},{"title":"Poate o integrare să expună furnizorii sau să ocolească aprobările?","description":"Nu. Identitatea și datele de contact ale furnizorilor rămân private, cu excepția cazului în care divulgarea este obligatorie, MerchandAise deține relația cu cumpărătorul, iar acțiunile care afectează comanda trebuie să păstreze etapele configurate de aprobare și de mostre fizice reale."}]},{"heading":"Prezentați-ne fluxul de lucru, nu o arhitectură finalizată.","paragraphs":["Spuneți-ne cine va folosi integrarea, ce stare trebuie să citească sau să modifice și unde va rula experiența. Vom mapa contractul, modelul de acces și cea mai sigură cale de lansare împreună cu dumneavoastră."],"items":[{"title":"Planificați o integrare","description":"/ro/contact?intent=api-integration-review"},{"title":"Explorați agenții AI și MCP","description":"/ro/developers/ai-agents-mcp"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"page-content","schema":"2025-11-05"}}