Acquista ora Guida API

Acquista ora Guida API

La seguente guida ha lo scopo di aiutare gli sviluppatori a comprendere come funzionano i servizi omacro Acquista ora nel tentativo di sviluppare una soluzione front-end personalizzata. Se non si ha familiarità con questo tipo di sviluppo, si consiglia vivamente di utilizzare la soluzione predefinita di omacro. Per ulteriori informazioni su Acquista ora, consulta la nostra Guida all'implementazione di Acquista ora fornitore .

Prerequisiti

Configura la rete per supportare Acquista ora

Potrebbe essere necessario assicurarsi che il firewall di rete sia configurato correttamente per comunicare con i servizi Web omacro al di fuori della rete. Ulteriori informazioni su Acquista ora Informazioni sul servizio per i professionisti della rete .

Panoramica

Gli endpoint del servizio Acquista ora possono essere chiamati per richiedere informazioni di base sul cliente, dati di configurazione Acquista ora e informazioni su rivenditori e prodotti. Questa guida delineerà questi endpoint e le loro funzioni.

Indirizzo dell'endpoint di base del servizio omacro

  1. https://services-v2.omacro.com/buynow/

Termini variabili utilizzati negli endpoint

Tieni presente che, per chiamare la maggior parte degli endpoint Acquista ora, ti potrebbe essere richiesto di fornire i seguenti parametri chiave:
  • companyId - L'identificatore univoco globale interno assegnato alla tua azienda da omacro (noto anche come "omacro ID" o GUID aziendale). Il parametro companyId può essere trovato nella pagina Acquista ora -> Codice sito o facendo clic sul nome della tua azienda nell'angolo in alto a sinistra del menu di navigazione di omacro. Il companyId apparirà nel parametro URL "id".
  • productId - L'identificatore univoco globale interno assegnato al tuo prodotto da omacro (noto anche come GUID del prodotto). In questo momento, il parametro productId può essere trovato all'interno della pagina omacro Prodotti -> Gestisci prodotto facendo clic sul modello del prodotto e avviando la pagina di visualizzazione "live". Il productid apparirà nell'URL come parametro "p".

Endpoint

Recupero dei dati
  • geolocalizzare
  • aziende/ {companyId:guid}
  • aziende/ {companyId:guid} /rivenditori/online
  • aziende/ {companyId:guid} /rivenditori/locale
  • aziende/ {companyId:guid} /validate
  • aziende/ {companyId:guid} /prodotti
  • aziende/ {companyId:guid} /prodotti/ {productId:guid} /rivenditori/online
  • aziende/ {companyId:guid} /prodotti/ {productId:guid} /rivenditori/locale
Monitoraggio analitico
  • transazione del rivenditore
  • transazione del prodotto
  • transazione del prodottosemplice
  • transazione del rivenditoresemplice

Di seguito è riportato un esempio di indirizzo endpoint completo: