Glossario

API di rete

  • interfacce di programmazione delle applicazioni che operano su una rete di computer. Comunicano utilizzando protocolli di rete, tra cui HTTP e gRPC, e sono spesso prodotte da organizzazioni diverse rispetto a quelle che le utilizzano.

API di Google

  • API di rete esposte dai servizi Google. La maggior parte è ospitata sul dominio googleapis.com. Puoi scoprire le API di Google disponibili utilizzando la console Google Cloud e l'API Service Usage. Questo termine non include altri tipi di API, quali librerie client e SDK.

API di Google Cloud

  • Il sottoinsieme di API di Google esposto dai servizi Google Cloud. Per ulteriori informazioni, consulta API Google Cloud.

Interfaccia API

  • Una definizione di service dei buffer di protocollo. Di solito è mappato a un'interfaccia nella maggior parte dei linguaggi di programmazione. Un'interfaccia API può essere implementata da un numero qualsiasi di servizi API.

Versione API

  • La versione di un'interfaccia API o di un gruppo di interfacce API, se definite insieme. Una versione dell'API è spesso rappresentata da una stringa, ad esempio "v1", e viene presentata nelle richieste API e nei nomi dei pacchetti dei buffer di protocollo.

Metodo API

  • Un'operazione singola all'interno di un'interfaccia API. È rappresentato nei buffer di protocollo da una definizione di rpc e in genere è mappato a una funzione in un'interfaccia nella maggior parte dei linguaggi di programmazione.

Richiesta API

  • Una singola chiamata a un metodo API. Viene spesso utilizzato come unità per la fatturazione, il logging, il monitoraggio e la limitazione di frequenza.

Servizio API

  • Un'implementazione di cui è stato eseguito il deployment di una o più interfacce API, esposte su uno o più indirizzi di rete, ad esempio l'API Cloud Pub/Sub.

Titolo API

  • Fa riferimento al titolo del prodotto rivolto agli utenti di un servizio API, ad esempio "API Cloud Pub/Sub".

Nome servizio API

  • Fa riferimento all'identificatore logico di un servizio API. Le API di Google utilizzano nomi compatibili con RFC 1035 DNS come nomi dei servizi API, ad esempio "pubsub.googleapis.com".

Endpoint del servizio API

  • Indica un indirizzo di rete che un servizio API utilizza per gestire le richieste API effettive. Esempi: https://pubsub.googleapis.com, https://content-pubsub.googleapis.com. Un singolo servizio può avere più di un endpoint.

Definizione del servizio API

  • La combinazione di definizioni di interfaccia API (file .proto) e configurazioni del servizio API (file .yaml) utilizzata per definire un servizio API. Lo schema per la definizione del servizio API di Google è google.api.Service.

Prodotto API

  • Un servizio API e i relativi componenti, quali Termini di servizio, documentazione, librerie client e assistenza per i servizi, vengono presentati collettivamente ai clienti come un prodotto. ad esempio l'API Google Calendar. A volte le persone si riferiscono ai prodotti API semplicemente come API.

Consumer API

  • L'entità che utilizza un servizio API. Per le API di Google, di solito si tratta di un progetto Google a cui appartiene l'applicazione client o la risorsa server.

Producer di API

  • L'entità che produce un servizio API. Per le API di Google, in genere il servizio API è di proprietà di Google.

Backend API

  • Un insieme di server e l'infrastruttura correlata che implementa la logica di business per un servizio API. Un singolo server di backend API viene spesso chiamato server API.

Frontend API

  • Un insieme di server e l'infrastruttura correlata che fornisce funzionalità comuni a tutti i servizi API, come bilanciamento del carico e autenticazione. Un singolo server frontend API è spesso chiamato proxy API.

    Tieni presente che il frontend dell'API e il backend dell'API possono essere eseguiti uno accanto all'altro o distanti tra loro. In alcuni casi, possono essere compilate in un unico programma binario dell'applicazione ed eseguite all'interno di un singolo processo.