Developer

Marketplace di API

Pubblica, misura e monetizza la tua API in un pomeriggio.

Marketplace di API is monetizzare api for teams that want the reasoning shown, not hidden. Plans start at $29 a month with a 14-day free trial.

Inizia la prova gratuita

Pubblicare un'API è la metà facile. La metà difficile è ciò che le sta intorno: gestione delle chiavi, misurazione dell'uso, limitazione della frequenza, fatturazione a consumo e una documentazione che non invecchia. Il Toolkit Marketplace API fornisce quello strato, così non passate tre mesi a costruire infrastruttura solo per vendere un'interfaccia pronta da un anno.

Chiavi, quote e limitazione

Ogni consumatore riceve chiavi con ambito proprio, ruotabili senza interruzione: una chiave nuova può valere accanto a quella vecchia finché il passaggio non è completo. Sembra ovvio ed è proprio quello che manca nelle soluzioni fatte in casa.

La limitazione funziona come token bucket per chiave e per endpoint, con capacità di picco sopra la frequenza sostenuta. Decisivi sono gli header di risposta: quota rimanente, momento di azzeramento e un `Retry-After` sul 429. Senza quegli header un client non può comportarsi bene, e allora torna con cicli infiniti.

Ambiti per chiave
Permessi per chiave invece che per account, così una chiave compromessa fa danno limitato.
Limitazione a token bucket
Frequenza sostenuta più picco, per chiave e per endpoint, con header di quota completi.
Misurazione del consumo
Conteggio per chiamata con registrazione idempotente, così un nuovo tentativo non fattura due volte.
Documentazione viva
Generata dallo schema OpenAPI, con esempi eseguibili contro un sandbox.

Fatturazione a consumo che torna

La fatturazione a consumo diventa difficile dove misurazione e fatturazione divergono. Una chiamata ripetuta dopo un timeout non deve contare due volte. Un errore di server dalla vostra parte non deve contare per nulla. E il contatore che il cliente vede deve essere lo stesso che finisce in fattura.

La misurazione qui è idempotente su un identificativo di chiamata, esclude le risposte 5xx e alimenta esattamente un contatore, letto sia dal portale cliente sia dalla fatturazione. Fasce di prezzo, quote gratuite e minimi vengono calcolati su quel contatore unico.

Versionamento e dismissione

Ogni API che vive abbastanza arriva a una seconda versione, e la transizione è il punto in cui i fornitori perdono i propri consumatori. Le versioni qui stanno nel percorso, con esercizio in parallelo e un piano di dismissione visibile negli header di risposta prima che compaia in una email.

Insieme arriva l'uso per versione: vedete quali consumatori sono ancora sulla versione vecchia e con quale volume, così la decisione di spegnere si appoggia a numeri. Un endpoint usato da tre clienti a dieci chiamate al giorno è una conversazione diversa da uno con metà del traffico.

Come limitazione e misurazione si combinano

Limitazione e fatturazione leggono gli stessi eventi ma prendono decisioni diverse. L'ordine conta, e qui è fissato.

  1. Verificare chiave e ambitoAutenticazione e autorizzazione vengono prima di tutto; le chiamate rifiutate non consumano quota e non vengono fatturate.
  2. Consultare la quotaIl token bucket della chiave viene verificato. Se non basta, segue un 429 con Retry-After, e la chiamata non raggiunge la vostra logica.
  3. Eseguire la richiestaLa chiamata va al vostro servizio; tempo di esecuzione e codice di stato vengono registrati.
  4. Contare come fatturabile solo in caso di successoLe risposte 5xx vengono registrate ma non fatturate — un guasto dalla vostra parte non è un servizio reso.
  5. Registrare in modo idempotenteIl conteggio avviene contro un identificativo di chiamata, così un nuovo tentativo con lo stesso identificativo non muove di nuovo il contatore.

Il quarto passaggio viene spesso dimenticato e costa fiducia più rapidamente di qualsiasi prezzo. Un cliente che paga per chiamate finite con un vostro errore di server controlla la fattura riga per riga la volta successiva — e allora trova anche tutto il resto.

A chi serve

SaaS che aprono un'API

La via più rapida da "abbiamo un'API interna" a "i clienti possono pagarla", senza costruire da zero lo strato di fatturazione.

Fornitori di dati

La fatturazione a consumo con fasce e quote gratuite è il prodotto stesso, e un contatore affidabile ne è il presupposto.

Team di piattaforma interna

Lo stesso strato senza fatturazione, ma con quote per team — utile quando un servizio interno viene travolto senza intenzione da un team vicino.

Team con una seconda versione di API

Uso per versione e header di dismissione visibili trasformano uno spegnimento rischioso in una procedura pianificata.

I termini di Marketplace di API spiegati

Ambito (scope)
La restrizione di ciò che una chiave può fare. Limita il danno quando una chiave finisce in mani sbagliate.
Token bucket
Un metodo di limitazione in cui la quota si ricarica continuamente e può essere accumulata fino a un tetto — permette picchi brevi senza alzare la frequenza sostenuta.
Header di quota
Header di risposta che indicano quota rimanente e momento di azzeramento. Senza di essi un client non può adattare il proprio comportamento.
Retry-After
L'header che dice a un client limitato quanto attendere. La sua assenza produce i cicli infiniti che si voleva evitare.
Idempotenza
La proprietà per cui una chiamata ripetuta produce lo stesso risultato della prima. Indispensabile per la fatturazione.
Fatturazione a consumo
Prezzo sull'uso effettivo invece che forfettario, di norma con quota gratuita e fasce.
OpenAPI
Il formato di schema per descrivere un'API HTTP. Utilizzabile come fonte per documentazione e generazione di client, così i due non divergono.
Dismissione (deprecation)
La fase annunciata in cui una versione funziona ancora ma non è più raccomandata. Conviene renderla visibile negli header, non solo nel changelog.

Informazioni su Marketplace di API

Annunci, endpoint documentati, piani con quota inclusa, chiavi con ambito limitato, conteggio per chiamata, condivisione dei ricavi e pagamenti. La quota viene verificata e consumata in un’unica transazione, quindi il limite regge anche sotto carico concorrente.

Marketplace di API starts at $29 a month with a 14-day free trial. RapidAPI is keeps 25% of your revenue revenue share.

Domande frequenti

Quale quota sui ricavi trattenete?

Il 5% su Marketplace, il 10% su Studio e il 15% su Publisher. RapidAPI trattiene un 25% fisso su ogni abbonamento ed eccedenza, quindi su 10.000 dollari di ricavi da API qui ne tieni 9.500 contro 7.500.

Come viene misurato l’utilizzo?

Ogni chiamata viene registrata con codice di stato, latenza e se era fatturabile. Le chiamate fallite e quelle bloccate dal limite sono registrate ma mai fatturate, e ogni rendiconto di pagamento è ricalcolato da quel registro, quindi è sempre verificabile.

Gli acquirenti possono provare prima di abbonarsi?

La console sandbox valida la richiesta rispetto allo schema dell’endpoint, applica la quota della chiave, simula il comportamento a monte compresi gli errori e mostra il costo progressivo: l’acquirente vede esattamente a cosa sta aderendo.

Cercato anche come: marketplace api · fatturazione a consumo api · alternativa a rapidapi · gestione chiavi api · limitazione quota api · vendere accesso api