Dla twórców API

Dystrybucja API: od publicznego przykładu do marketplace’ów

Programiści wybierają API, które mogą wypróbować w kilka minut. Dlatego dystrybucja API działa inaczej niż w przypadku każdego innego produktu: sprzedają publiczny przykład i dokumentacja, a każdy marketplace, każda sieć i każda lista na nich się opiera. Ten plan układa kanały w kolejności, cytuje ich prawdziwe wymagania i sprawdza z nimi twój plik OpenAPI.

Krótka odpowiedź

  1. Spraw, by pierwsze udane wywołanie było banalne: jeden bazowy URL, klucz w jednym kroku, request do skopiowania i prawdziwa odpowiedź tuż obok.
  2. Trzymaj jeden plik OpenAPI jako jedyne źródło. Postman i RapidAPI zalecają jego import, a APIs.guru potrzebuje do niego stabilnego URL-a.
  3. Potem dodaj API tam, gdzie programiści już szukają: do Postman API Network, do RapidAPI Hub, jeśli chcesz wbudowanych rozliczeń, do public-apis, jeśli masz darmowy plan, i do APIs.guru dla samej definicji.
  4. Zrób premierę, gdy wszystko działa bez rozmowy handlowej: Show HN i Product Hunt, a do tego serwer MCP, jeśli aplikacje AI mają wywoływać twoje API jako narzędzia.

Kanały po kolei

Każdy krok wykorzystuje pracę poprzedniego. Jeśli pominiesz dwa pierwsze, każdy późniejszy wpis będzie słabszy.

KanałCo ci dajeCzego wymagaKoszt
1 Twoja dokumentacja i publiczny przykładStrona, do której linkuje każdy inny kanał i na której programiści podejmują decyzję.Bazowy URL, auth w jednym kroku, request do skopiowania, jego odpowiedź, czytelne błędy.Twój czas
2 Postman API NetworkWidoczność w Postmanie i w wynikach organicznych; kolekcje, które programiści mogą forkować.Publiczny workspace z kolekcją referencyjną zaimportowaną z OpenAPI i kolekcją przeglądową.Dokumentacja dla wydawców nie podaje opłaty
3 RapidAPI HubJego bazę użytkowników, profil zoptymalizowany pod wyszukiwarki, klucze i rozliczenia.Projekt API (import OpenAPI), publiczna widoczność, plany cenowe, PayPal do wypłat.Wpis za darmo; 25% płatności
4 public-apisJedna linia na kuratorowanej liście z 485 tys. gwiazdek na GitHubie.Darmowy dostęp lub darmowy plan, HTTPS, informacje o Auth i CORS, opis do 100 znaków.Za darmo; marketingowe pull requesty są odrzucane
5 APIs.guruTwoja definicja w publicznym katalogu definicji API.Stabilny URL do definicji czytelnej maszynowo, na przykład OpenAPI.Formularz nie podaje opłaty
6 Serwer MCP dla twojego APIAplikacje AI mogą wywoływać twoje API jako narzędzia.Serwer, który opakowuje twoje API, wpisany do rejestrów MCP.Główne rejestry są darmowe
7 Product HuntJeden dzień premiery przed early adopterami.Działający publiczny przykład i strona zrozumiała także dla osób spoza IT.Za darmo
8 Show HNProgramiści, którzy testują nowe rzeczy i mówią, co o nich myślą.Coś, co można od razu wypróbować, prosty tytuł i ty w komentarzach.Za darmo

Nazwy kanałów prowadzą do oficjalnych stron lub do naszego profilu platformy. Celowo nie wymieniamy tu innych marketplace’ów.

Zacznij od publicznego przykładu

Postman ujmuje to w jednym zdaniu: sukces zaczyna się od pierwszego 200 OK w jak najmniejszej liczbie kroków. Napisz przykład przed jakimkolwiek wpisem, bo każdy wpis będzie kierował do niego ludzi.

  1. Jeden bazowy URLUmieść go na górze dokumentacji i na liście servers w pliku OpenAPI, zawsze HTTPS.
  2. Klucz w jednym krokuOd rejestracji do klucza bez rozmowy handlowej. Wystarczy klucz testowy albo darmowy plan z małym limitem.
  3. Request do skopiowaniaPełne polecenie ze wszystkimi nagłówkami. Programiści wklejają je, zanim przeczytają cokolwiek innego.
  4. Prawdziwa odpowiedźPokaż JSON, który naprawdę wraca, razem z polami potrzebnymi w następnym kroku.
  5. Błędy, które wyjaśniająOpisz odpowiedzi 4xx: brak klucza, zły parametr, wyczerpany limit, każdą z jej komunikatem.
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." }
Przykładowy request i odpowiedź w formie, jaką powinna pokazywać twoja dokumentacja (example.com to placeholder).

Sprawdź swój plik OpenAPI

Wklej swój openapi.json. Kontrola odczytuje to, co kanały z wpisami z niego biorą (tytuł, wersję, serwery, operacje, przykłady, auth), i pokazuje, na który kanał jesteś gotowy. Dostajesz plan w Markdown i, jeśli spełniasz warunki, linię w formacie public-apis. Wszystko działa w twojej przeglądarce; nic nie jest wysyłane.

Co mówi plik: –

Kontrole

  • Dokument OpenAPI 3.x
  • info.title jest ustawione
  • info.version jest ustawione
  • Opis ma co najmniej 40 znaków
  • Jednolinijkowy opis do 100 znaków
  • Publiczny URL serwera HTTPS
  • Co najmniej jedna operacja
  • Każda operacja ma summary lub description
  • Wartości operationId są unikalne
  • Przykłady requestów lub odpowiedzi
  • Odpowiedzi błędów przy każdej operacji (4xx, 5xx lub default)
  • Typ auth odczytany dla wpisów
  • Link do kontaktu lub dokumentacji
  • Link do regulaminu

Gotowe dla

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

Linia w formacie public-apis

–

Kontrola nie pobiera URL-i, nie wywołuje twojego API i niczego nie zgłasza. Czyta tylko tekst, który wklejasz.

Dlaczego plik OpenAPI ma znaczenie

ZasadaOficjalne brzmienieCo to dla ciebie znaczy
TytułThe title of the API.info.title jest wymagane; staje się nazwą w każdym wpisie.
operationIdThe id MUST be unique among all operations described in the API.Zduplikowane ID psują importy i generowany kod; każde musi być unikalne.
Najpierw importIf you have one, we strongly suggest you start by importing your file.Zacznij projekt w RapidAPI od pliku OpenAPI, a nie ręcznie.
Kolekcja referencyjnaPostman recommends you import your OpenAPI definition to create your API reference collection.Zaimportuj plik OpenAPI; nie odtwarzaj requestów ręcznie.
DefinicjaThe 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.Bez definicji czytelnej maszynowo nie ma wpisu.
Stabilny URLSo please, provide us with a stable URL to the definition.Udostępniaj definicję pod URL-em, który nie zmienia się między wersjami.

Sprzedaż przez RapidAPI

RapidAPI to marketplace, o który chodzi większości osób pytających, jak sprzedawać API. Wpis jest darmowy; oddajesz część tego, co zarobisz. Nowe API startują jako prywatne, więc projekt pojawi się w hubie dopiero wtedy, gdy ustawisz go jako publiczny.

Przy planie za US$100 dostajesz US$75 przy prowizji 25%, wypłacane przez PayPal. Darmowy plan jest ograniczony do 1000 requestów na godzinę i 500 000 na miesiąc.

  1. Zaimportuj plik OpenAPI przy tworzeniu projektu; uzupełni endpointy i parametry.
  2. Napisz krótki i długi opis, ustaw kategorię, stronę i bazowy URL, a potem wgraj logo.
  3. Daj mały darmowy plan do testów, a potem płatne plany z jasnymi limitami i opłatami za przekroczenia.
  4. Podłącz PayPal przed pierwszą wypłatą; Rapid nie wypłaca dostawcom pieniędzy w żaden inny sposób.
  5. Zachowaj własną dokumentację i stronę z cennikiem: marketplace to kanał, a nie twoja jedyna witryna.
ZasadaOficjalne brzmienieCo to dla ciebie znaczy
Koszt wpisuIt is also free and easy to add your API to the hub.Dodanie API do RapidAPI nic nie kosztuje.
Co dostajeszAdding 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.Strona profilu, klucze i rozliczenia przychodzą razem z wpisem.
Domyślnie prywatneWhen a user or team creates an API, by default it is a private API.Przełącz widoczność na publiczną, inaczej nikt nie znajdzie API.
Darmowy planHaving a free pricing plan (with a small number of requests available) is vital to a good experience for a developer using your API.Mały darmowy limit pozwala programistom testować, zanim zapłacą.
Limity darmoweFree API plans are limited to 1000 requests per hour and 500K requests per month.Większe użycie wymaga planu płatnego lub pay-per-use.
Prowizja marketplace’uRapid takes a flat 25% marketplace fee on all payments made through the API Hub.Ustalaj ceny planów z myślą o udziale 25%.
WypłatyRapid currently only pays out API providers via PayPal.Podłącz konto PayPal, zanim cokolwiek zarobisz.

Postman, public-apis i APIs.guru

Te trzy nic nie kosztują i docierają do programistów dokładnie wtedy, gdy szukają API. Każdy ma własne zasady; trzymaj się ich, a wpis zostanie.

ZasadaOficjalne brzmienieCo to dla ciebie znaczy
Pierwsze wywołanieThis starts with getting your API consumers to their first 200 OK response in the fewest steps possible.Oceniaj dokumentację po tym, jak szybko obca osoba dostaje 200 OK.
WidocznośćSharing APIs on the Postman API Network increases your API’s discovery in organic and Postman search results.Publiczny workspace pojawia się w wyszukiwarce Postmana i w wynikach wyszukiwania w sieci.
SekretyIf Postman detects any API keys, tokens, or similar, it replaces them with placeholders.I tak używaj zmiennych na klucze w publicznych kolekcjach.
Zweryfikowany wydawcaVerify your team’s identity by verifying you own your domain.Odznaka wymaga domeny, którą kontrolujesz.
Darmowy dostępPlease 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.API dostępne tylko płatnie nie pasują do tej listy.
Bez marketinguPull requests that are identified as marketing attempts will not be accepted.Opisz, co API robi, a nie dlaczego jest najlepsze.
OpisThe Description should not exceed 100 characters.Linia może mieć najwyżej 100 znaków.

Premiera API

Premiera działa najlepiej, gdy przykład i co najmniej jeden wpis są już online, żeby każdy odwiedzający mógł wykonać wywołanie tego samego dnia.

Show HN
Publikuj, gdy ludzie mogą wypróbować API bez rozmowy z tobą. Prosty tytuł, przykład w pierwszym komentarzu i szybkie odpowiedzi liczą się bardziej niż godzina. Jak przeprowadzić premierę projektu na Show HN →
Product Hunt
Pokaż, co API umożliwia, a nie tylko endpointy: krótkie demo, darmowy plan i stronę zrozumiałą dla osoby spoza IT.
Serwer MCP
Jeśli aplikacje AI mają korzystać z twojego API, opakuj je w serwer MCP i opublikuj go w rejestrach MCP. To osobny produkt z własnymi wpisami. Katalogi serwerów MCP: 10 miejsc dla twojego serwera →
Twój changelog
Każdy nowy endpoint czy SDK to powód, by znów coś opublikować. Prowadź publiczny changelog i linkuj do niego z dokumentacji.

Gdzie pasuje LaunchRepo

LaunchRepo działa w twoim agencie kodującym. Agent zgłasza stronę twojego produktu do dużego katalogu katalogów i platform startowych i prowadzi tracker, który oddziela aktywne wpisy od oczekujących.

Konta w marketplace’ach, plany cenowe, wypłaty i serwer MCP zostają po twojej stronie, bo wymagają twoich kluczy i decyzji. LaunchRepo nie zgłasza API do RapidAPI, Postman ani list na GitHubie; zajmuje się ogólnymi formularzami katalogów dla strony twojego API.

Źródła

Każdą zasadę i liczbę sprawdziliśmy 1 października 2026 na stronie samego wydawcy i cytujemy dosłownie po angielsku. Kopie tekstów przechowujemy razem z naszymi dowodami.

Najczęstsze pytania

Jak promować API?
Zacznij od publicznego przykładu, który w kilka minut doprowadzi obcą osobę do pierwszego udanego wywołania, a potem dodaj API tam, gdzie szukają programiści: do Postman API Network, do RapidAPI, jeśli chcesz wbudowanych rozliczeń, do public-apis dla darmowych API i do APIs.guru dla definicji. Zrób premierę na Show HN i Product Hunt, gdy wszystko działa bez twojej pomocy.
Jak sprzedawać API na RapidAPI?
Utwórz projekt API w RapidAPI Studio, zaimportuj plik OpenAPI, uzupełnij wpis w hubie, dodaj plany cenowe, ustaw API jako publiczne i podłącz PayPal do wypłat. Wpis jest darmowy; w dniu sprawdzenia Rapid pobierał stałą prowizję marketplace’u w wysokości 25% od płatności.
Czy potrzebuję pliku OpenAPI?
Nie dla każdego kanału, ale oszczędza najwięcej pracy. RapidAPI i Postman zalecają jego import, a APIs.guru przyjmuje tylko definicje czytelne maszynowo. Trzymaj jeden plik jako jedyne źródło dla dokumentacji i wpisów.
Czy płatne API może trafić na listę public-apis?
Tylko jeśli oferuje pełny darmowy dostęp albo przynajmniej darmowy plan i nie wymaga kupna urządzenia ani usługi. Maintainerzy odrzucają pull requesty, które wyglądają na marketing.
Czy moje API powinno być też serwerem MCP?
Jeśli aplikacje AI mają wywoływać je jako narzędzie, tak, jako osobny serwer, który opakowuje API. Wpisuje się go do rejestrów MCP, a nie do marketplace’ów API.
Czy LaunchRepo dodaje moje API do RapidAPI lub Postman?
Nie. Te wpisy wymagają twoich kont, kluczy, cen i danych do wypłat. LaunchRepo zgłasza stronę twojego produktu do ogólnych katalogów i platform startowych przez twojego agenta kodującego.

Niech twój agent zajmie się katalogami

Jeden zakup, twój agent kodujący, każdy produkt, który zbudujesz: LaunchRepo zgłasza stronę twojego API do katalogów i platform startowych, a ty w tym czasie ulepszasz dokumentację.

Zobacz cennik