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.