Per sviluppatori di API

Distribuire una API: dall’esempio pubblico ai marketplace

Gli sviluppatori adottano una API che possono provare in pochi minuti. Per questo distribuire una API è diverso da qualsiasi altro prodotto: a vendere sono l’esempio pubblico e la documentazione, e ogni marketplace, rete e lista si appoggia su di loro. Questo piano mette in ordine i canali, cita i loro requisiti reali e controlla il tuo file OpenAPI rispetto a essi.

Risposta breve

  1. Rendi banale la prima chiamata riuscita: un URL base, una chiave in un solo passaggio, una richiesta da copiare e la risposta reale subito accanto.
  2. Tieni un unico file OpenAPI come fonte. Postman e RapidAPI consigliano entrambi di importarlo, e APIs.guru ha bisogno di un URL stabile che punti a esso.
  3. Poi pubblica dove gli sviluppatori cercano già: Postman API Network, RapidAPI Hub se vuoi la fatturazione integrata, public-apis se hai un piano gratuito e APIs.guru per la definizione stessa.
  4. Lancia quando funziona senza una call commerciale: Show HN e Product Hunt, più un server MCP se le applicazioni AI devono chiamare la tua API come strumenti.

I canali in ordine

Ogni passaggio riusa il lavoro di quello precedente. Saltare i primi due indebolisce tutte le schede successive.

CanaleCosa ti dàCosa richiedeCosto
1 La tua documentazione e un esempio pubblicoLa pagina a cui rimandano tutti gli altri canali e dove gli sviluppatori decidono.URL base, autenticazione in un passaggio, una richiesta da copiare, la sua risposta, errori leggibili.Il tuo tempo
2 Postman API NetworkVisibilità in Postman e nella ricerca organica; collection di cui gli sviluppatori possono fare il fork.Un workspace pubblico con una collection di riferimento importata da OpenAPI e una collection di panoramica.La documentazione per i publisher non indica alcuna tariffa
3 RapidAPI HubLa sua base utenti, una pagina profilo ottimizzata per la ricerca, chiavi e fatturazione.Un progetto API (import da OpenAPI), visibilità pubblica, piani tariffari e PayPal per i pagamenti.Pubblicare è gratis; 25% dei pagamenti
4 public-apisUna riga in una lista curata con 485.000 stelle su GitHub.Accesso gratuito o un piano gratuito, HTTPS, informazioni su Auth e CORS e una descrizione di massimo 100 caratteri.Gratis; le pull request di marketing vengono rifiutate
5 APIs.guruLa tua definizione in una directory pubblica di definizioni di API.Un URL stabile verso una definizione leggibile dalle macchine, come OpenAPI.Il modulo non indica alcuna tariffa
6 Un server MCP per la tua APILe applicazioni AI possono chiamare la tua API come strumenti.Un server che incapsula la tua API, pubblicato nei registry MCP.I registry principali sono gratuiti
7 Product HuntUn giorno di lancio davanti agli early adopter.Un esempio pubblico funzionante e una pagina comprensibile anche per chi non programma.Gratis
8 Show HNSviluppatori che provano le cose e dicono cosa ne pensano.Qualcosa da provare subito, un titolo semplice e tu nei commenti.Gratis

I nomi dei canali rimandano alle pagine ufficiali o al nostro profilo della piattaforma. Di proposito qui non nominiamo altri marketplace.

Parti da un esempio pubblico

Postman lo dice in una frase: il successo inizia con il primo 200 OK nel minor numero di passaggi. Scrivi l’esempio prima di qualsiasi scheda, perché ogni scheda manderà le persone lì.

  1. Un URL baseMettilo in cima alla documentazione e nella lista servers del tuo file OpenAPI, sempre con HTTPS.
  2. Una chiave in un passaggioDalla registrazione alla chiave senza call commerciale. Basta una chiave di test o un piano gratuito con una piccola quota.
  3. Una richiesta da copiareUn comando completo con tutti gli header. Gli sviluppatori lo incollano prima di leggere qualsiasi altra cosa.
  4. La risposta realeMostra il JSON che torna davvero, compresi i campi che servono subito dopo.
  5. Errori che spieganoDocumenta le risposte 4xx: chiave mancante, parametro errato, quota esaurita, ognuna con il suo messaggio.
curl "https://api.example.com/v1/forecast?city=Berlin" \
  -H "X-API-Key: $API_KEY"

HTTP/1.1 200 OK
{ "city": "Berlin",
  "days": [{ "date": "2026-10-01", "temp_c": 14.2 }] }

HTTP/1.1 401 Unauthorized
{ "error": "missing_api_key",
  "message": "Send your key in the X-API-Key header." }
Una richiesta e una risposta di esempio nella forma che la tua documentazione dovrebbe mostrare (example.com è un segnaposto).

Controlla il tuo file OpenAPI

Incolla il tuo openapi.json. Il controllo legge ciò che i canali di pubblicazione ne ricavano (titolo, versione, servers, operazioni, esempi, autenticazione) e mostra quale canale è pronto. Ottieni un piano in Markdown e, se hai i requisiti, la riga nel formato di public-apis. Funziona nel tuo browser; non viene caricato nulla.

Cosa dice il file: –

Controlli

  • Documento OpenAPI 3.x
  • info.title è impostato
  • info.version è impostato
  • Descrizione di almeno 40 caratteri
  • Descrizione di una riga di massimo 100 caratteri
  • URL pubblico del server con HTTPS
  • Almeno un’operazione
  • Ogni operazione ha summary o description
  • I valori di operationId sono univoci
  • Esempi di richiesta o risposta
  • Risposte di errore su ogni operazione (4xx, 5xx o default)
  • Tipo di autenticazione letto per le schede
  • Link di contatto o alla documentazione
  • Link ai termini di servizio

Pronto per

  • Postman API Network
  • RapidAPI Hub
  • public-apis
  • APIs.guru

Riga nel formato di public-apis

–

Il controllo non apre URL, non chiama la tua API e non invia nulla. Legge solo il testo che incolli.

Perché il file OpenAPI conta

RegolaTesto ufficialeCosa significa per te
TitoloThe title of the API.info.title è obbligatorio; diventa il nome in ogni scheda.
operationIdThe id MUST be unique among all operations described in the API.ID duplicati rompono gli import e il codice generato; mantienili tutti univoci.
Prima l’importIf you have one, we strongly suggest you start by importing your file.Avvia il progetto RapidAPI dal tuo file OpenAPI, non a mano.
Collection di riferimentoPostman recommends you import your OpenAPI definition to create your API reference collection.Importa il file OpenAPI; non ricostruire le richieste.
DefinizioneThe most important requirement is the presence of a machine-readable API definition in one of the popular formats, such as: OpenAPI (formerly known as Swagger), RAML, API Blueprint, etc.Senza una definizione leggibile dalle macchine, niente scheda.
URL stabileSo please, provide us with a stable URL to the definition.Servi la definizione a un URL che non cambia tra una versione e l’altra.

Vendere tramite RapidAPI

RapidAPI è il marketplace a cui pensano quasi tutti quando chiedono come vendere una API. Pubblicare è gratis; paghi una quota di ciò che guadagni. Le nuove API partono private, quindi un progetto non compare nell’hub finché non lo rendi pubblico.

Con un piano da US$100 ricevi US$75 con una commissione del 25%, pagati tramite PayPal. Un piano gratuito è limitato a 1000 richieste all’ora e 500.000 al mese.

  1. Importa il tuo file OpenAPI quando crei il progetto; compila endpoint e parametri.
  2. Scrivi una descrizione breve e una lunga, imposta categoria, sito e URL base, e carica un logo.
  3. Offri un piccolo piano gratuito per i test degli sviluppatori, poi piani a pagamento con quote ed eccedenze chiare.
  4. Collega PayPal prima del primo pagamento; Rapid non paga i provider in nessun altro modo.
  5. Mantieni la tua documentazione e la tua pagina prezzi: il marketplace è un canale, non la tua unica vetrina.
RegolaTesto ufficialeCosa significa per te
Costo della schedaIt is also free and easy to add your API to the hub.Aggiungere una API a RapidAPI non costa nulla.
Cosa ottieniAdding your API to the rapidapi.com hub gets you instant exposure to our growing user base, a search engine-optimized profile page for your API, as well as features like user management and billing services.Con la scheda arrivano una pagina profilo, le chiavi e la fatturazione.
Privata per impostazione predefinitaWhen a user or team creates an API, by default it is a private API.Imposta la visibilità su pubblica, altrimenti nessuno trova la API.
Piano gratuitoHaving a free pricing plan (with a small number of requests available) is vital to a good experience for a developer using your API.Una piccola quota gratuita permette agli sviluppatori di provare prima di pagare.
Limiti gratuitiFree API plans are limited to 1000 requests per hour and 500K requests per month.Un uso più intenso richiede un piano a pagamento o a consumo.
Commissione del marketplaceRapid takes a flat 25% marketplace fee on all payments made through the API Hub.Definisci i prezzi dei piani tenendo conto del 25%.
PagamentiRapid currently only pays out API providers via PayPal.Collega un account PayPal prima di guadagnare qualcosa.

Postman, public-apis e APIs.guru

Questi tre non costano nulla e raggiungono gli sviluppatori proprio quando cercano una API. Ognuno ha le sue regole; se le segui, la scheda resta.

RegolaTesto ufficialeCosa significa per te
Prima chiamataThis starts with getting your API consumers to their first 200 OK response in the fewest steps possible.Misura la tua documentazione da quanto in fretta uno sconosciuto ottiene un 200 OK.
VisibilitàSharing APIs on the Postman API Network increases your API’s discovery in organic and Postman search results.Un workspace pubblico compare nella ricerca di Postman e nei risultati dei motori di ricerca.
SegretiIf Postman detects any API keys, tokens, or similar, it replaces them with placeholders.Usa comunque variabili per le chiavi nelle collection pubbliche.
Publisher verificatoVerify your team’s identity by verifying you own your domain.Il badge richiede un dominio che controlli.
Accesso gratuitoPlease make sure the API you want to add has full, free access or at least a free tier and does not depend on the purchase of a device/service before submitting.Le API solo a pagamento non trovano posto in questa lista.
Niente marketingPull requests that are identified as marketing attempts will not be accepted.Descrivi cosa fa la API, non perché è la migliore.
DescrizioneThe Description should not exceed 100 characters.Tieni la riga entro i 100 caratteri.

Lancia la API

Un lancio funziona meglio quando l’esempio e almeno una scheda sono già online, così ogni visitatore può fare una chiamata lo stesso giorno.

Show HN
Pubblica quando le persone possono provare la API senza parlare con te. Un titolo semplice, l’esempio nel primo commento e risposte rapide contano più dell’orario. Come lanciare il tuo progetto su Show HN →
Product Hunt
Mostra cosa rende possibile la API, non solo gli endpoint: una demo breve, un piano gratuito e una pagina che capisce anche chi non sviluppa.
Un server MCP
Se le applicazioni AI devono usare la tua API, incapsulala in un server MCP e pubblicalo nei registry MCP. È un prodotto a sé, con le sue schede. Directory di server MCP: 10 posti dove pubblicare il tuo server →
Il tuo changelog
Ogni nuovo endpoint o SDK è un motivo per pubblicare di nuovo. Tieni un changelog pubblico e collegalo dalla documentazione.

Dove si inserisce LaunchRepo

LaunchRepo lavora dentro il tuo coding agent. L’agente invia il sito del tuo prodotto a un ampio catalogo di directory e piattaforme di lancio e tiene un tracker che separa le schede pubblicate da quelle in attesa.

Gli account sui marketplace, i piani tariffari, i pagamenti e il server MCP restano a te, perché richiedono le tue chiavi e le tue decisioni. LaunchRepo non invia API a RapidAPI, Postman o alle liste su GitHub; si occupa dei moduli delle directory generaliste per il sito della tua API.

Fonti

Ogni regola e ogni numero sono stati verificati in data 1 ottobre 2026 sulla pagina dell’editore stesso e sono citati parola per parola in inglese. Le copie del testo sono conservate con le nostre prove.

FonteUltimo aggiornamentoVerificato
OpenAPI Specification v3.1.1
RapidAPI docs: What is rapidapi.com?nessuna data indicata
RapidAPI docs: Adding APIs - Getting Startednessuna data indicata
RapidAPI docs: Hub Listing - Overviewnessuna data indicata
RapidAPI docs: Hub Listing - General Tabnessuna data indicata
RapidAPI docs: Monetizing Your API on rapidapi.comnessuna data indicata
RapidAPI docs: Payouts and Financenessuna data indicata
Postman Docs: Postman API Network overviewnessuna data indicata
Postman Docs: Showcase your public APIs on the Postman API Networknessuna data indicata
Postman Docs: Become a verified publisher on the Postman API Networknessuna data indicata
Postman Docs: Prepare your public collectionsnessuna data indicata
public-apis/public-apis: CONTRIBUTING.mdnessuna data indicata
public-apis/public-apisnessuna data indicata
APIs.guru: Add APInessuna data indicata

Domande frequenti

Come si promuove una API?
Parti da un esempio pubblico che porta uno sconosciuto alla prima chiamata riuscita in pochi minuti, poi pubblica la API dove cercano gli sviluppatori: Postman API Network, RapidAPI se vuoi la fatturazione integrata, public-apis per le API gratuite e APIs.guru per la definizione. Lancia su Show HN e Product Hunt quando funziona senza il tuo aiuto.
Come si vende una API su RapidAPI?
Crea un progetto API in RapidAPI Studio, importa il tuo file OpenAPI, compila la scheda dell’hub, aggiungi i piani tariffari, rendi pubblica la API e collega PayPal per i pagamenti. Pubblicare è gratis; alla data del controllo Rapid tratteneva una commissione fissa del 25% del marketplace sui pagamenti.
Mi serve un file OpenAPI?
Non per ogni canale, ma è ciò che fa risparmiare più lavoro. RapidAPI e Postman consigliano entrambi di importarlo, e APIs.guru elenca solo definizioni leggibili dalle macchine. Tieni un unico file come fonte per documentazione e schede.
Una API a pagamento può entrare nella lista public-apis?
Solo se offre accesso gratuito completo o almeno un piano gratuito e non richiede l’acquisto di un dispositivo o di un servizio. I maintainer rifiutano le pull request che sembrano marketing.
La mia API dovrebbe essere anche un server MCP?
Se le applicazioni AI devono chiamarla come strumento, sì, come server separato che incapsula la API. Si pubblica nei registry MCP, non nei marketplace di API.
LaunchRepo pubblica la mia API su RapidAPI o Postman?
No. Quelle schede richiedono i tuoi account, le tue chiavi, i prezzi e i dati per i pagamenti. LaunchRepo invia il sito del tuo prodotto a directory generaliste e piattaforme di lancio tramite il tuo coding agent.

Lascia le directory al tuo agente

Un solo acquisto, il tuo coding agent, ogni prodotto che crei: LaunchRepo invia il sito della tua API a directory e piattaforme di lancio mentre tu migliori la documentazione.

Vedi i prezzi