Vai al contenuto principale

[Order Intake - GCW] Come usare gli endpoint API per ordini senza dati cliente

S
Scritto da Styrbjörn Holmberg
Aggiornato oltre 3 settimane fa

Puoi recuperare e cercare tutti gli ordini dei clienti usando gli endpoint API, non solo quelli di un cliente specifico. Ecco come fare:

1. Crea un connettore

  1. Vai su Order Intake → Connectors.

  2. Crea un nuovo connettore.

  3. Scegli API Connector.

  4. Seleziona Tutti i clienti.

  5. Dagli un nome, ad esempio: Customer-Agnostic Connector.

  6. Copia la tua X-API-KEY.

  7. Fai clic su Crea.

Ora hai i tuoi endpoint pronti.


2. Imposta le tue richieste API

A. Fai un ordine singolo

  • Metodo:GET

  • Endpoint: usa l'endpoint Get Order dal tuo connettore.

  • Intestazioni:

    • X-API-KEY: [la tua chiave copiata]

  • Corpo: Nessuno richiesto.

  • Passaggi:

    1. Sostituisci {orderId} nell'URL con un vero ID ordine.

    2. Fai clic su Invia.

    3. Riceverai i dettagli dell’ordine.

B. Cerca tra più ordini

  • Metodo:POST

  • Endpoint: usa l'endpoint Search Orders dal tuo connettore.

  • Intestazioni:

    • X-API-Key: [la tua chiave copiata]

  • Corpo: inserisci i tuoi filtri di ricerca in formato JSON.

Passaggi:

  1. Incolla l'endpoint di ricerca.

  2. Imposta il metodo su POST.

  3. Aggiungi il corpo JSON.

  4. Fai clic su Invia.

  5. Riceverai un elenco di ordini corrispondenti.


Errori da evitare spesso

  • Metodo sbagliato:GET per un ordine con cucitura singola, POST per la ricerca.

  • Nessuna API Key: ricorda di inserire sempre la tua X-API-KEY nell'intestazione.

  • Manca il corpo per la ricerca: per cercare, serve un corpo JSON con i tuoi filtri.

Hai ricevuto la risposta alla tua domanda?