Mi piacerebbe fornire un metodo molto leggero per descrivere i miei servizi web. Nessun WSDL, WADL o materiale complesso simile. Solo una mappatura dall'URL di base del servizio Web a una semplice descrizione che può essere rilevata e analizzata automaticamente. Fondamentalmente
- Il nome del servizio
- Un link ad alcuni documenti leggibili dall'uomo (facoltativo)
- Forse un contatto indirizzo
- Condizioni di utilizzo, pattern URL, ecc. sono meno necessari per semplificare.
Il meglio che ho trovato è Documenti Descrizione OpenSearch , ma prima potrebbe essere più semplice con testo normale file di configurazione e in secondo luogo non esiste uno standard su come collegare questi documenti di descrizione del servizio a servizi Web arbitrari (solo autodiscovery in ATOM / RSS e HTML).
Ho pensato di creare il mio formato personale e di fornirlo in modo simile a robots.txt
:
$ curl http://example.org/services.txt
service: http://example.org/foobar
name: Foobar API
about: http://example.org/foobar-doc.html
service: http://example.org/some/unapi
name: Example ORG's unAPI
# additional fields, to be discussed
standard: http://unapi.info
pattern: ?id={id}&format={format}
Quindi, se conosci l'URL di base di un servizio, come http://example.org/some/unapi
, puoi cercare almeno il nome nel file di descrizione del servizio.
Invece di definire il mio standard, tuttavia, vorrei sapere se esiste già qualcosa di simile da riutilizzare.