Swagger/OpenAPI Specification on tapa kuvata rajapintoja. Sen tuorein (2017) määritelmä on githubissa. Kuvasin swagger-editorilla TAMKin avoimen Opetussuunnitelmat/Opintojaksot ja niiden toteutukset  APIn:

tamk4.yaml tai  tamk4.json.

Hyvin alustava mutta toimiva kuvaus on liittenä yllä. Testasin myös onnistuneesti swagger-editorin tuottaman java-clientin. Testiohjelmat TAMKrealizationClient.java. ja TAMKCurricumClient.java.

https://stackoverflow.com/questions/24118243/how-to-generate-json-schema-from-swagger-api-declaration

  • No labels