Krótka odpowiedź
- Spraw, by pierwsze udane wywołanie było banalne: jeden bazowy URL, klucz w jednym kroku, request do skopiowania i prawdziwa odpowiedź tuż obok.
- Trzymaj jeden plik OpenAPI jako jedyne źródło. Postman i RapidAPI zalecają jego import, a APIs.guru potrzebuje do niego stabilnego URL-a.
- 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.
- 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 daje | Czego wymaga | Koszt |
|---|---|---|---|
| 1 Twoja dokumentacja i publiczny przykład | Strona, 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 Network | Widoczność 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 Hub | Jego 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-apis | Jedna 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.guru | Twoja 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 API | Aplikacje 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 Hunt | Jeden 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 HN | Programiś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.
Wpisz swoje narzędzie tam, gdzie programiści naprawdę szukają. →
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.
- Jeden bazowy URLUmieść go na górze dokumentacji i na liście servers w pliku OpenAPI, zawsze HTTPS.
- Klucz w jednym krokuOd rejestracji do klucza bez rozmowy handlowej. Wystarczy klucz testowy albo darmowy plan z małym limitem.
- Request do skopiowaniaPełne polecenie ze wszystkimi nagłówkami. Programiści wklejają je, zanim przeczytają cokolwiek innego.
- Prawdziwa odpowiedźPokaż JSON, który naprawdę wraca, razem z polami potrzebnymi w następnym kroku.
- 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." }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.
Dlaczego plik OpenAPI ma znaczenie
| Zasada | Oficjalne brzmienie | Co to dla ciebie znaczy |
|---|---|---|
| Tytuł | The title of the API. | info.title jest wymagane; staje się nazwą w każdym wpisie. |
| operationId | The id MUST be unique among all operations described in the API. | Zduplikowane ID psują importy i generowany kod; każde musi być unikalne. |
| Najpierw import | If you have one, we strongly suggest you start by importing your file. | Zacznij projekt w RapidAPI od pliku OpenAPI, a nie ręcznie. |
| Kolekcja referencyjna | Postman recommends you import your OpenAPI definition to create your API reference collection. | Zaimportuj plik OpenAPI; nie odtwarzaj requestów ręcznie. |
| Definicja | The 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 URL | So please, provide us with a stable URL to the definition. | Udostępniaj definicję pod URL-em, który nie zmienia się między wersjami. |
Sprawdź slogan pod kątem limitu znaków na każdej platformie →
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.
- Zaimportuj plik OpenAPI przy tworzeniu projektu; uzupełni endpointy i parametry.
- Napisz krótki i długi opis, ustaw kategorię, stronę i bazowy URL, a potem wgraj logo.
- Daj mały darmowy plan do testów, a potem płatne plany z jasnymi limitami i opłatami za przekroczenia.
- Podłącz PayPal przed pierwszą wypłatą; Rapid nie wypłaca dostawcom pieniędzy w żaden inny sposób.
- Zachowaj własną dokumentację i stronę z cennikiem: marketplace to kanał, a nie twoja jedyna witryna.
| Zasada | Oficjalne brzmienie | Co to dla ciebie znaczy |
|---|---|---|
| Koszt wpisu | It is also free and easy to add your API to the hub. | Dodanie API do RapidAPI nic nie kosztuje. |
| Co dostajesz | Adding 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 prywatne | When 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 plan | Having 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 darmowe | Free 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’u | Rapid 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łaty | Rapid 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.
| Zasada | Oficjalne brzmienie | Co to dla ciebie znaczy |
|---|---|---|
| Pierwsze wywołanie | This 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. |
| Sekrety | If Postman detects any API keys, tokens, or similar, it replaces them with placeholders. | I tak używaj zmiennych na klucze w publicznych kolekcjach. |
| Zweryfikowany wydawca | Verify your team’s identity by verifying you own your domain. | Odznaka wymaga domeny, którą kontrolujesz. |
| Darmowy dostęp | Please 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 marketingu | Pull requests that are identified as marketing attempts will not be accepted. | Opisz, co API robi, a nie dlaczego jest najlepsze. |
| Opis | The 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.
| Źródło | Ostatnia aktualizacja | Sprawdzono |
|---|---|---|
| OpenAPI Specification v3.1.1 | ||
| RapidAPI docs: What is rapidapi.com? | brak daty | |
| RapidAPI docs: Adding APIs - Getting Started | brak daty | |
| RapidAPI docs: Hub Listing - Overview | brak daty | |
| RapidAPI docs: Hub Listing - General Tab | brak daty | |
| RapidAPI docs: Monetizing Your API on rapidapi.com | brak daty | |
| RapidAPI docs: Payouts and Finance | brak daty | |
| Postman Docs: Postman API Network overview | brak daty | |
| Postman Docs: Showcase your public APIs on the Postman API Network | brak daty | |
| Postman Docs: Become a verified publisher on the Postman API Network | brak daty | |
| Postman Docs: Prepare your public collections | brak daty | |
| public-apis/public-apis: CONTRIBUTING.md | brak daty | |
| public-apis/public-apis | brak daty | |
| APIs.guru: Add API | brak daty |
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