Je suis nouveau à la documentation fanfaronnade. Nous avons un projet existant développé en langage pour les services Web RESTFul. Les différentes URL basées sur les ressources consomment et produisent au format application / json. Les formats json d’entrée et de sortie de l’une de nos ressources sont indiqués ci-dessous:

{
"request": {
"companyNumber": 5000,
"operatorInit": "sys",
"operatorPassword": "",
"customerNumber": 101,
"shipTo": "",
"warehouse": "01",
"productCode": "2-001",
"crossReferenceFlag": false,
"retrieveFlag": false,
"tInbinlocation": {
"t-inbinlocation": [
{
"binloc": "",
"icswbinloc1fl": false,
"icswbinloc2fl": false,
"addrecordfl": false,
"deleterecordfl": false,
"charuser": "",
"user1": "",
"user2": "",
"user3": "",
"user4": "",
"user5": "",
"user6": 0,
"user7": 0,
"user8": null,
"user9": null
}
]
},
"tInfieldvalue": {
"t-infieldvalue": [
{
"level": "",
"lineno": 0,
"seqno": 0,
"fieldname": "",
"fieldvalue": ""
}
]
}
}
}

Réponse:

{
"response": {
"cErrorMessage": "",
"crossReferenceProduct": "2-001",
"crossReferenceType": "",
"tOutbinlocation": {
"t-outbinlocation": []
},
"tOutfieldvalue": {
"t-outfieldvalue": []
}
}
}

Comment convertir les formats de requête et de réponse JSON ci-dessus en format Jag swagger 2.0?

Merci!

Réponses:

Essayez d'utiliser api-spec-converter.
Cet outil prend en charge la conversion des descriptions d'API entre les formats courants.

  Supported formats:
* swagger_1
* swagger_2
* api_blueprint
* io_docs
* google
* raml
* wadl