esposizioni
Una decisione, presa una volta per tutte, che stabilisce che uno schermo può lasciare questa azienda: quali colonne, quali righe e se è possibile riscrivervi qualcosa. Nulla è accessibile dall'esterno finché non viene pubblicato qui, e non esiste un "pubblicare tutto".
Dove trovarlo
- Modulo: Piattaforma
- Gruppo: Connettività
- Sezione: API pubblicata
- Schermo: esposizioni
Indirizzo nella console: /platform/api-exposures
Lista · 11 colonne · 16 campi sulla sua forma · 4 di loro richiesto
Cosa mostra l'elenco
Queste sono le colonne dell'elenco, nell'ordine in cui vengono visualizzate. Ognuna di esse può essere utilizzata per ordinare, filtrare, nascondere o esportare i dati.
| Colonna | Tipo | Nome del campo |
|---|---|---|
| Pubblicato come | Codice | code |
| Nome | Testo | name |
| Modulo | Stato | module_key |
| Schermo | Codice | resource_key |
| Accesso | Stato | access_summary |
| Colonne | Testo | column_summary |
| Numero massimo di righe | Numero | max_rows |
| Chiavi | Numero | granted_to |
| Chiamate (30 giorni) | Numero | calls_30d |
| Ultima chiamata | Data e ora | last_called_at |
| Stato | Stato | status |
Il modulo
Ecco cosa viene richiesto quando si crea un record. I campi obbligatori sono contrassegnati; una scelta tratta da un elenco di configurazione è una di quelle che un amministratore può estendere senza bisogno di una nuova versione.
| Campo | Tipo | Scelte | Note |
|---|---|---|---|
| Pubblicato come necessario | Testo | È così che il mondo esterno lo chiama. Si tratta dell'URL e del nome dello strumento MCP, volutamente separati dal nome della schermata, in modo che rinominare una schermata qui non comprometta mai l'integrazione di nessuno. | |
| Nome necessario | Testo | ||
| Che cos'è | Testo lungo | Letto da uno sviluppatore nel documento OpenAPI e da un modello nell'elenco degli strumenti MCP. Vale la pena sottolinearlo: è l'unico punto in cui viene specificato che "ordini" qui si riferisce agli ordini di acquisto. | |
| Modulo necessario | Testo | Seleziona gli elementi dallo strumento di selezione in API Studio anziché digitarli: l'elenco viene letto direttamente dal prodotto. | |
| Schermo necessario | Testo | ||
| Può essere letto | sì o no | ||
| Può essere creato | sì o no | La creazione tramite API segue le stesse regole di convalida, numerazione e pubblicazione di una creazione effettuata digitando sullo schermo. | |
| Potrebbe essere modificato | sì o no | ||
| Potrebbe essere eliminato | sì o no | ||
| Colonne | Scelta | elencato, Tutto, tutti tranne | elencato — solo ciò che è indicato di seguito, e nient'altro viene mai inviato. tutto — tutte le colonne. tutto_tranne — tutto tranne ciò che è indicato di seguito. |
| Nomi delle colonne | Testo | Separati da virgole. Un nome scritto in modo errato qui non viene visualizzato, quindi usa il selettore in API Studio dove puoi vedere cosa c'è effettivamente sullo schermo. | |
| file che possono viaggiare | Testo | Lo stesso filtro viene visualizzato in ogni schermata dell'elenco: {"col":"status","op":"eq","value":"posted"}. Viene applicato sul server ad ogni chiamata e un filtro inviato dal chiamante viene combinato con un'operazione AND al di sotto di esso: nulla di ciò che possono inviare lo amplia. | |
| Numero massimo di righe per chiamata | Numero | ||
| Offerto come strumento MCP | sì o no | ||
| Cosa dire a una modella | Testo lungo | Solo quando un modello ha bisogno di informazioni che uno sviluppatore non richiederebbe. Se lasciato vuoto, viene utilizzata la descrizione sopra riportata. | |
| Stato | Scelta | bozza, attivo, sospeso, pensionato | È raggiungibile solo un'esposizione attiva. Una bozza è una decisione che qualcuno sta ancora scrivendo. |
Le regole che si applicano qui
Tutto ciò che appare su questa schermata obbedisce alle regole della piattaforma, non a regole proprie. Ecco quelle che è bene conoscere prima di utilizzarla:
- Restringere un elenco — ricerca, condizioni, ordinamento, totali, esportazione e visualizzazioni salvate.
- Cosa può essere modificato — I cinque motivi per cui un documento non può essere modificato.
- Aziende e unità aziendali — cosa sta facendo lo switcher sopra questo elenco.
- Creazione di un record — Campi obbligatori, provenienza delle opzioni e modalità di assegnazione dei valori.
- Importazione di un foglio di calcolo — Questa schermata ne accetta uno e segue le stesse regole della digitazione.