Pour les développeurs d’API

Distribuer une API : de l’exemple public aux marketplaces

Les développeurs adoptent une API qu’ils peuvent essayer en quelques minutes. C’est ce qui distingue la distribution d’une API de celle de tout autre produit : l’exemple public et la documentation font la vente, et chaque marketplace, réseau ou liste s’appuie sur eux. Ce plan met les canaux dans l’ordre, cite leurs exigences réelles et vérifie votre fichier OpenAPI par rapport à elles.

Réponse courte

  1. Rendez le premier appel réussi trivial : une seule URL de base, une clé en une étape, une requête à copier et la vraie réponse juste à côté.
  2. Gardez un seul fichier OpenAPI comme source unique. Postman et RapidAPI recommandent tous deux de l’importer, et APIs.guru a besoin d’une URL stable vers ce fichier.
  3. Inscrivez ensuite l’API là où les développeurs cherchent déjà : le Postman API Network, le RapidAPI Hub si vous voulez une facturation intégrée, public-apis si vous avez une offre gratuite, et APIs.guru pour la définition elle-même.
  4. Lancez dès que tout fonctionne sans appel commercial : Show HN et Product Hunt, plus un serveur MCP si des applications d’IA doivent appeler votre API comme outil.

Les canaux dans l’ordre

Chaque étape réutilise le travail de la précédente. Sauter les deux premières affaiblit toutes les fiches suivantes.

CanalCe qu’il vous apporteCe qu’il demandeCoût
1 Votre documentation et un exemple publicLa page vers laquelle pointent tous les autres canaux, et où les développeurs se décident.URL de base, authentification en une étape, une requête à copier, sa réponse, des erreurs lisibles.Votre temps
2 Postman API NetworkDe la visibilité dans Postman et dans la recherche organique ; des collections que les développeurs peuvent forker.Un workspace public avec une collection de référence importée depuis OpenAPI et une collection de présentation.Aucun frais mentionné dans la documentation éditeur
3 RapidAPI HubSa base d’utilisateurs, une page de profil optimisée pour la recherche, les clés et la facturation.Un projet d’API (import OpenAPI), une visibilité publique, des plans tarifaires, PayPal pour les versements.Inscription gratuite ; 25 % des paiements
4 public-apisUne ligne dans une liste sélectionnée qui compte 485 000 étoiles sur GitHub.Un accès gratuit ou une offre gratuite, HTTPS, les infos Auth et CORS, une description de 100 caractères maximum.Gratuit ; les pull requests marketing sont refusées
5 APIs.guruVotre définition dans un répertoire public de définitions d’API.Une URL stable vers une définition lisible par machine, comme OpenAPI.Aucun frais sur le formulaire
6 Un serveur MCP pour votre APILes applications d’IA peuvent appeler votre API comme outil.Un serveur qui encapsule votre API, inscrit dans les registres MCP.Les principaux registres sont gratuits
7 Product HuntUne journée de lancement devant des early adopters.Un exemple public qui fonctionne et une page que les non-développeurs comprennent aussi.Gratuit
8 Show HNDes développeurs qui testent et disent ce qu’ils en pensent.Quelque chose à essayer tout de suite, un titre simple, et vous dans les commentaires.Gratuit

Les noms des canaux renvoient aux pages officielles ou à notre fiche de la plateforme. Nous ne citons volontairement aucune autre marketplace ici.

Commencez par un exemple public

Postman le résume en une phrase : le succès commence par le premier 200 OK, avec le moins d’étapes possible. Écrivez l’exemple avant toute fiche, car chaque fiche y enverra du monde.

  1. Une seule URL de basePlacez-la en haut de la documentation et dans la liste servers de votre fichier OpenAPI, toujours en HTTPS.
  2. Une clé en une étapeDe l’inscription à la clé sans appel commercial. Une clé de test ou un plan gratuit avec un petit quota suffit.
  3. Une requête à copierUne commande complète avec tous les en-têtes. Les développeurs la collent avant de lire quoi que ce soit d’autre.
  4. La vraie réponseMontrez le JSON réellement renvoyé, y compris les champs dont on a besoin ensuite.
  5. Des erreurs qui expliquentDocumentez les réponses 4xx : clé manquante, paramètre erroné, quota atteint, chacune avec son message.
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." }
Un exemple de requête et de réponse, tel que votre documentation devrait le montrer (example.com est un exemple fictif).

Vérifiez votre fichier OpenAPI

Collez votre openapi.json. Le check lit ce que les canaux de référencement en tirent (titre, version, servers, opérations, exemples, authentification) et indique quel canal est prêt. Vous obtenez un plan en Markdown et, si vous remplissez les conditions, la ligne au format public-apis. Tout se passe dans votre navigateur ; rien n’est envoyé.

Ce que dit le fichier : –

Vérifications

  • Document OpenAPI 3.x
  • info.title est renseigné
  • info.version est renseigné
  • Description d’au moins 40 caractères
  • Description d’une ligne, 100 caractères maximum
  • URL de serveur HTTPS publique
  • Au moins une opération
  • Chaque opération a un résumé ou une description
  • Les valeurs operationId sont uniques
  • Exemples de requête ou de réponse
  • Réponses d’erreur sur chaque opération (4xx, 5xx ou default)
  • Type d’authentification lu pour les fiches
  • Lien de contact ou de documentation
  • Lien vers les conditions d’utilisation

Prêt pour

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

Ligne au format public-apis

–

Le check ne charge aucune URL, n’appelle pas votre API et ne soumet rien. Il lit seulement le texte que vous collez.

Pourquoi le fichier OpenAPI compte

RègleFormulation officielleCe que cela signifie pour vous
TitreThe title of the API.info.title est obligatoire ; il devient le nom dans chaque fiche.
operationIdThe id MUST be unique among all operations described in the API.Des ID en double cassent les imports et le code généré ; gardez chacun unique.
Importer d’abordIf you have one, we strongly suggest you start by importing your file.Démarrez le projet RapidAPI depuis votre fichier OpenAPI, pas à la main.
Collection de référencePostman recommends you import your OpenAPI definition to create your API reference collection.Importez le fichier OpenAPI ; ne reconstruisez pas les requêtes.
DéfinitionThe 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.Pas de définition lisible par machine, pas de fiche.
URL stableSo please, provide us with a stable URL to the definition.Servez la définition à une URL qui ne change pas d’une version à l’autre.

Vendre via RapidAPI

RapidAPI est la marketplace à laquelle la plupart des gens pensent quand ils se demandent comment vendre une API. L’inscription est gratuite ; vous reversez une part de ce que vous gagnez. Les nouvelles API démarrent en privé : un projet n’apparaît donc pas dans le hub tant que vous ne le rendez pas public.

Sur un plan à 100 $ US, vous recevez 75 $ US avec une commission de 25 %, versés via PayPal. Un plan gratuit est plafonné à 1 000 requêtes par heure et 500 000 par mois.

  1. Importez votre fichier OpenAPI à la création du projet ; il remplit les endpoints et les paramètres.
  2. Rédigez une description courte et une longue, choisissez la catégorie, renseignez le site web et l’URL de base, et ajoutez un logo.
  3. Proposez un petit plan gratuit pour que les développeurs puissent tester, puis des plans payants avec des quotas et des dépassements clairs.
  4. Associez PayPal avant le premier versement ; Rapid ne paie les fournisseurs par aucun autre moyen.
  5. Gardez votre propre documentation et votre page de tarifs : la marketplace est un canal, pas votre unique vitrine.
RègleFormulation officielleCe que cela signifie pour vous
Coût de la ficheIt is also free and easy to add your API to the hub.Ajouter une API à RapidAPI ne coûte rien.
Ce que vous obtenezAdding 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.Une page de profil, les clés et la facturation sont incluses avec la fiche.
Privé par défautWhen a user or team creates an API, by default it is a private API.Passez la visibilité en public, sinon personne ne trouve l’API.
Plan gratuitHaving a free pricing plan (with a small number of requests available) is vital to a good experience for a developer using your API.Un petit quota gratuit permet aux développeurs de tester avant de payer.
Limites gratuitesFree API plans are limited to 1000 requests per hour and 500K requests per month.Un usage plus intensif demande un plan payant ou à l’usage.
Commission de la marketplaceRapid takes a flat 25% marketplace fee on all payments made through the API Hub.Fixez vos prix en tenant compte de la part de 25 %.
VersementsRapid currently only pays out API providers via PayPal.Associez un compte PayPal avant de gagner quoi que ce soit.

Postman, public-apis et APIs.guru

Ces trois-là ne coûtent rien et touchent les développeurs au moment où ils cherchent une API. Chacun a ses propres règles ; respectez-les et la fiche reste en ligne.

RègleFormulation officielleCe que cela signifie pour vous
Premier appelThis starts with getting your API consumers to their first 200 OK response in the fewest steps possible.Mesurez votre documentation au temps qu’il faut à un inconnu pour obtenir un 200 OK.
VisibilitéSharing APIs on the Postman API Network increases your API’s discovery in organic and Postman search results.Un workspace public apparaît dans la recherche Postman et dans les résultats de recherche web.
SecretsIf Postman detects any API keys, tokens, or similar, it replaces them with placeholders.Utilisez quand même des variables pour les clés dans les collections publiques.
Éditeur vérifiéVerify your team’s identity by verifying you own your domain.Le badge demande un domaine que vous contrôlez.
Accès gratuitPlease 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.Les API uniquement payantes n’ont pas leur place dans cette liste.
Pas de marketingPull requests that are identified as marketing attempts will not be accepted.Décrivez ce que fait l’API, pas pourquoi elle est la meilleure.
DescriptionThe Description should not exceed 100 characters.Limitez la ligne à 100 caractères maximum.

Lancer l’API

Un lancement fonctionne mieux une fois l’exemple et au moins une fiche en ligne, pour que chaque visiteur puisse faire un appel le jour même.

Show HN
Publiez quand on peut essayer l’API sans vous parler. Un titre simple, l’exemple dans le premier commentaire et des réponses rapides comptent plus que l’heure de publication. Comment lancer votre projet sur Show HN →
Product Hunt
Montrez ce que l’API rend possible, pas seulement les endpoints : une courte démo, un plan gratuit et une page qu’un non-développeur comprend.
Un serveur MCP
Si des applications d’IA doivent utiliser votre API, encapsulez-la dans un serveur MCP et publiez-le dans les registres MCP. C’est un produit à part, avec ses propres fiches. Annuaires de serveurs MCP : 10 endroits où lister votre serveur →
Votre changelog
Chaque nouvel endpoint ou SDK est une raison de publier à nouveau. Tenez un changelog public et liez-le depuis la documentation.

La place de LaunchRepo

LaunchRepo fonctionne dans votre agent de code. L’agent soumet le site web de votre produit à un large catalogue d’annuaires et de plateformes de lancement, et tient un suivi qui distingue les fiches en ligne de celles en attente.

Les comptes sur les marketplaces, les plans tarifaires, les versements et le serveur MCP restent entre vos mains, car ils demandent vos clés et vos décisions. LaunchRepo ne soumet pas d’API à RapidAPI, à Postman ni aux listes GitHub ; il se charge des formulaires d’annuaires généralistes pour le site web de votre API.

Sources

Chaque règle et chaque chiffre ont été vérifiés le 1 octobre 2026 sur la page de l’éditeur et sont cités mot pour mot en anglais. Des copies du texte sont conservées avec nos preuves.

SourceDernière mise à jourVérifié
OpenAPI Specification v3.1.1
RapidAPI docs: What is rapidapi.com?aucune date indiquée
RapidAPI docs: Adding APIs - Getting Startedaucune date indiquée
RapidAPI docs: Hub Listing - Overviewaucune date indiquée
RapidAPI docs: Hub Listing - General Tabaucune date indiquée
RapidAPI docs: Monetizing Your API on rapidapi.comaucune date indiquée
RapidAPI docs: Payouts and Financeaucune date indiquée
Postman Docs: Postman API Network overviewaucune date indiquée
Postman Docs: Showcase your public APIs on the Postman API Networkaucune date indiquée
Postman Docs: Become a verified publisher on the Postman API Networkaucune date indiquée
Postman Docs: Prepare your public collectionsaucune date indiquée
public-apis/public-apis: CONTRIBUTING.mdaucune date indiquée
public-apis/public-apisaucune date indiquée
APIs.guru: Add APIaucune date indiquée

Questions fréquentes

Comment promouvoir une API ?
Commencez par un exemple public qui mène un inconnu à un premier appel réussi en quelques minutes, puis inscrivez l’API là où les développeurs cherchent : le Postman API Network, RapidAPI si vous voulez une facturation intégrée, public-apis pour les API gratuites et APIs.guru pour la définition. Lancez sur Show HN et Product Hunt dès que tout fonctionne sans votre aide.
Comment vendre une API sur RapidAPI ?
Créez un projet d’API dans RapidAPI Studio, importez votre fichier OpenAPI, remplissez la fiche du hub, ajoutez des plans tarifaires, rendez l’API publique et associez PayPal pour les versements. L’inscription est gratuite ; à la date de vérification, Rapid prélevait une commission fixe de 25 % sur les paiements.
Ai-je besoin d’un fichier OpenAPI ?
Pas pour tous les canaux, mais c’est lui qui fait gagner le plus de travail. RapidAPI et Postman recommandent tous deux de l’importer, et APIs.guru ne référence que des définitions lisibles par machine. Gardez un seul fichier comme source unique pour la documentation et les fiches.
Une API payante peut-elle entrer dans la liste public-apis ?
Seulement si elle offre un accès entièrement gratuit ou au moins une offre gratuite, sans achat d’appareil ni de service. Les mainteneurs refusent les pull requests qui ressemblent à du marketing.
Mon API doit-elle aussi être un serveur MCP ?
Si des applications d’IA doivent l’appeler comme outil, oui, sous la forme d’un serveur distinct qui encapsule l’API. Il s’inscrit dans les registres MCP, pas sur les marketplaces d’API.
LaunchRepo inscrit-il mon API sur RapidAPI ou Postman ?
Non. Ces fiches demandent vos comptes, vos clés, vos tarifs et vos informations de versement. LaunchRepo soumet le site web de votre produit aux annuaires généralistes et aux plateformes de lancement via votre agent de code.

Laissez votre agent s’occuper des annuaires

Un seul achat, votre agent de code, tous les produits que vous créez : LaunchRepo soumet le site web de votre API aux annuaires et aux plateformes de lancement pendant que vous améliorez la documentation.

Voir les tarifs