Glossario

API di rete

  • interfacce di programmazione delle applicazioni che operano su una rete computer. Comunicano utilizzando protocolli di rete, compreso HTTP e gRPC, e sono spesso prodotti da diverse organizzazioni rispetto a quelli che li consumano.

API di Google

  • API di rete esposte dai servizi Google. La maggior parte di questi è ospitata su Dominio googleapis.com. Puoi scoprire le API di Google disponibili utilizzando Console Google Cloud e l'API Service Usage. Questo termine non include altri tipi di API, come librerie client e SDK.

API di Google Cloud

  • Il sottoinsieme delle API di Google esposte dai servizi Google Cloud. Per ulteriori informazioni vedi API Google Cloud.

Interfaccia API

  • Una definizione service di Protocol Buffers. In genere è mappato a uno nella maggior parte dei linguaggi di programmazione. Un'interfaccia API può essere da un qualsiasi numero di Servizi API.

Versione API

  • La versione di un'interfaccia API o un gruppo di interfacce API, se presenti definiti insieme. Una versione dell'API è spesso rappresentata da una stringa, ad esempio "v1", e viene visualizzata nelle richieste API e nei nomi dei pacchetti Protocol Buffers.

Metodo API

  • Una singola operazione all'interno di un'interfaccia API. È rappresentato in Protocol Buffers da una definizione 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 utilizzata come unità per fatturazione, logging, monitoraggio e 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, come API Cloud Pub/Sub.

Titolo dell'API

  • Si riferisce al titolo del prodotto rivolto all'utente di un servizio API, come "API Cloud Pub/Sub".

Nome servizio API

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

Endpoint servizio API

  • Si riferisce a un indirizzo di rete utilizzato da un servizio API per fornire richieste API. 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 API Configurazioni del servizio (file .yaml) utilizzate per definire un servizio API. Lo schema per la definizione del servizio API di Google è google.api.Service

Prodotto API

  • Un servizio API più componenti correlati, come i Termini di servizio, documentazione, librerie client e assistenza per i servizi, sono presentati ai clienti come un prodotto. Ad esempio, l'API Google Calendar. A volte i prodotti API vengono chiamati semplicemente come API.

Consumer API

  • L'entità che utilizza un servizio API. Per le API Google, in genere si tratta di un progetto Google che possiede l'applicazione client o la risorsa del server.

Producer API

  • L'entità che produce un servizio API. Per le API di Google, in genere si tratta di un progetto Google proprietario del servizio API.

Backend API

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

Frontend API

  • Un insieme di server più la relativa infrastruttura che fornisce una funzionalità comune ai servizi API, come il bilanciamento del carico autenticazione. Un singolo server frontend dell'API è spesso chiamato proxy API.

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