Documenter un service XML-RPC

Question

J'écris un service XML-RPC qui sera consommé par des tiers et je me demandais quelle serait la meilleure façon de le documenter. Autant que je peux voir, XML-RPC n'a pas d'équivalent au WSDL de SOAP pour fournir une description du service, donc probablement que je devrais documenter à la main? Jusqu'à présent, je suis tombé sur des exemples tels que ceux trouvés here et here où la documentation se compose essentiellement d'un exemple d'appel avec des espaces réservés pour les données.

Y at-il une meilleure méthode que celle qui me manque? Merci.

Answer 1

Découvrez XML-RPC Introspection. Il s'agit de la chose la plus proche d'une norme que vous allez trouver. XML-RPC se prête à des documents simples de descriptions d'entrée/sortie. Si vous voulez quelque chose qui peut être traité par programme, alors implémentez ou activez l'introspection.