# Documentație API și integrări OpenAPI | MerchandAise

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

Explorează documentația API și specificațiile OpenAPI MerchandAise pentru produse personalizate, comunități încorporate, furnizori și identitatea companiilor.

## Alege conexiunea de care are nevoie proiectul tău
Folosește referințele de mai jos pentru a evalua endpointurile, formatele cererilor și cerințele de autorizare. Specificațiile publice susțin planificarea și generarea clienților software; accesul operațional depinde de API, cont și mediu.
Când MerchandAise procesează tranzacția cumpărătorului, Hutter Products GmbH este vânzătorul contractual și Merchant of Record sub marca MerchandAise. Identitatea și datele de contact ale furnizorilor rămân private, cu excepția dezvăluirilor impuse, iar producția necesită în continuare aprobarea machetei digitale, fezabilitate confirmată, verificări tehnice obligatorii și aprobările mostrelor aplicabile comenzii exacte acceptate.

## Interfețe API și de integrare
- **Documentație API și OpenAPI:** Găsește referința API pentru instrumentele asistenților și sesiunile de design, apoi alege contractul de comunitate, furnizor sau companie pentru procesul tău. Ghid de implementare: Citește documentația instrumentelor asistenților (/api/docs). Contract pentru sisteme: JSON OpenAPI pentru instrumentele asistenților (/api/docs/openapi.json). Acces: Public. Referință publică pentru API-urile asistenților și instrumentelor. Accesul de producție și operațiunile care afectează comenzile necesită în continuare autorizarea aplicabilă. Pagină canonică: /ro/developers/api-integrations. Secțiune canonică: /ro/developers/api-integrations#api-docs.
- **API pentru comunități:** Conectează site-ul unui club sau al unei comunități la informațiile publice ale comunității, propunerile de design, voturi și transferurile pentru aprobarea comenzilor. Ce acoperă contractul: Contextul public al comunității, postările de design și voturile, publicarea listărilor, comenzile în așteptare și aprobarea sau respingerea de către proprietarul comunității. Un punct practic de plecare: Citește contextul public al comunității pentru site-ul unui club. Apoi identifică acțiunile care necesită o sesiune de membru sau permisiuni de proprietar, înainte să adaugi propuneri de design sau transferuri către finalizarea comenzii. Acces: Specificația este publică. Citirile publice, acțiunile membrilor și operațiunile rezervate proprietarului au cerințe diferite de autorizare; respectă regulile de securitate ale fiecărui endpoint. Ghid de implementare: Descoperă API-ul comunităților (/ro/developers/api-integrations#community-integrations). Contract pentru sisteme: JSON OpenAPI pentru comunități (/api/v1/community/public/openapi/v1). Acces: Public. Contract public versionat pentru magazine încorporate, descoperirea comunităților și transferuri care păstrează limba și regiunea. Pagină canonică: /ro/developers/api-integrations. Secțiune canonică: /ro/developers/api-integrations#community-integrations.
- **API pentru furnizori:** Conectează sistemele furnizorilor aprobați la pachetele de producție eliberate, starea înscrierii și procesele webhook ERP sau PLM. Ce acoperă contractul: Starea înscrierii furnizorilor, pachete de producție eliberate, descărcări de fișiere auditate, analize, abonamente webhook și puncte de sincronizare. Un punct practic de plecare: Planifică o conexiune între sistemul tău ERP sau de gestionare a ciclului de viață al produselor și Centrul furnizorilor. Verifică datele webhook, reîncercările și starea sincronizării înainte de a procesa o comandă atribuită. Acces: Citește specificația OpenAPI fără autentificare. Cererile operaționale necesită contul și permisiunile corespunzătoare de furnizor; documentația publică nu înscrie un furnizor și nu oferă acces la datele altui furnizor. Ghid de implementare: Descoperă API-ul furnizorilor (/ro/developers/api-integrations#supplier-integrations). Contract pentru sisteme: JSON OpenAPI pentru furnizori (/api/v1/supplier/openapi/v1). Acces: Public. Contract public pentru planificare și generarea clienților software. Accesul operațional al furnizorilor rămâne condiționat de permisiuni. Pagină canonică: /ro/developers/api-integrations. Secțiune canonică: /ro/developers/api-integrations#supplier-integrations.
- **API de identitate pentru companii:** Conectează spațiile de lucru aprobate ale companiilor la autentificare unică, configurarea utilizatorilor și grupurilor și jurnale de audit al identității. Ce acoperă contractul: Autentificare unică OpenID Connect (OIDC), operațiuni SCIM pentru ciclul de viață al utilizatorilor și grupurilor, rotația tokenurilor SCIM și evenimente de audit ale configurării. Un punct practic de plecare: Conectează furnizorul de identitate la spațiul de lucru aprobat. Planifică autentificarea, crearea și dezactivarea utilizatorilor, apoi verifică mapările grupurilor și jurnalele de audit în mediul de testare convenit. Acces: Specificația de identitate pentru companii este protejată. Contactează echipa de integrări pentru a analiza spațiul de lucru și cerințele de acces înainte de implementare. Identitatea de companie este opțională pentru achizițiile obișnuite de produse. Ghid de implementare: Descoperă identitatea pentru companii (/ro/developers/api-integrations#enterprise-integrations). Contract pentru sisteme: JSON OpenAPI de identitate pentru companii (/api/v1/enterprise/identity/openapi/v1). Acces: Protejat. Contract protejat pentru spațiile de lucru aprobate ale companiilor; solicită acces înainte de a folosi acest endpoint. Pagină canonică: /ro/developers/api-integrations. Secțiune canonică: /ro/developers/api-integrations#enterprise-integrations.

## Alege contractul înaintea codului
- **Pasul 1: Definește parcursul utilizatorului:** Stabilește cine intră în proces și de unde: un cumpărător într-un magazin încorporat, un furnizor aprobat, un utilizator de companie sau un asistent care operează cu autorizare explicită.
- **Pasul 2: Confirmă limita accesului:** Folosește contractele publice pentru evaluare și generarea clienților software, apoi confirmă datele de acces, domeniile, mediile, callbackurile și endpointurile protejate înainte de implementare.
- **Pasul 3: Demonstrează continuitatea stării:** Testează dacă designurile, ofertele, aprobările, erorile și transferurile comenzilor păstrează versiunea actuală în integrare, inclusiv reîncercările și parcursurile de revenire.

## Ce trebuie să păstreze fiecare integrare
- **O singură stare versionată:** Designul, intenția comercială, oferta susținută de furnizor, aprobarea și starea comenzii rămân conectate. Modificările bazate pe date învechite trebuie să declanșeze vizibil o ofertă nouă sau o analiză.
- **Confidențialitate comercială și a furnizorilor:** MerchandAise rămâne comerciantul și responsabilul de asistență în relația cu cumpărătorul. Identitățile, contactele și datele interne ale furnizorilor nu sunt expuse prin integrările publice.
- **Aprobare înainte de producție:** O vizualizare 3D nu este o dovadă fizică. Oferta confirmată explică opțiunile disponibile de mostre pentru client, costurile, limitele și termenele. Aprobă macheta digitală exactă și efectuează verificările tehnice obligatorii și aprobarea mostrelor necesare sau alese înainte de producția în serie. Cerințele unei comenzi deja acceptate rămân obligatorii.

## Înainte de traficul de producție
Un fișier OpenAPI publicat este un instrument de planificare, nu o promisiune de acces anonim în producție. Analizăm mediile, datele de acces, tratarea erorilor și responsabilitatea operațională înainte de lansare.
- **Acces și medii:** Confirmă versiunea contractului, spațiul de lucru aprobat, domeniile de autentificare, mediul de testare, datele de acces în producție și destinațiile callback.
- **Erori și recuperare:** Definește reîncercările, idempotența, timpii de așteptare, erorile vizibile clientului, monitorizarea, responsabilitatea asistenței și revenirea înainte de lansare.
- **Dovezi pentru întregul parcurs:** Verifică parcursul dorit în mediul de testare, de la intrare și modificarea stării la ofertă, aprobare, transfer și recuperare.

## Întrebări frecvente
- **Cu ce API de produse personalizate ar trebui să încep?:** Începe cu persoana și schimbarea de stare. Folosește comunitățile încorporate pentru parcursuri de club sau comunitate destinate cumpărătorilor, operațiunile furnizorilor pentru procese aprobate de producție, identitatea companiilor pentru SSO și SCIM și instrumentele asistenților numai pentru procese AI autorizate explicit.
- **Un contract public înseamnă acces public în producție?:** Nu. Un contract OpenAPI public susține descoperirea, analiza arhitecturii și generarea clienților software. Datele de acces în producție, operațiunile de scriere, procesele furnizorilor, identitatea companiilor și execuția asistenților pot necesita în continuare un spațiu de lucru aprobat și autorizare limitată.
- **O integrare poate expune furnizorii sau ocoli aprobările?:** Nu. Identitatea și datele de contact ale furnizorilor rămân private, cu excepția dezvăluirilor impuse, MerchandAise gestionează relația cu cumpărătorul, iar acțiunile care afectează comenzile trebuie să păstreze cerințele configurate de aprobare a machetei digitale, verificare tehnică și mostre specifice comenzii.

## Planifică integrarea cu noi.
Spune-ne cine va folosi integrarea, ce stare trebuie să citească sau să modifice și unde va exista experiența. Stabilim împreună contractul, modelul de acces și cel mai sigur parcurs de lansare.
- **Planifică o integrare:** /ro/contact?intent=api-integration-review
- **Descoperă agenții AI și MCP:** /ro/developers/ai-agents-mcp
