Peki, bariz bir tutarlı adlandırma tutmak olacaktır. Fonksiyonlar ve sınıflar hem uygulamalarında (değil aynı ise) benzer adlı olmalıdır. Iki farklı dilde ayrı bir API uygulamak zaman bu genellikle doğal olur. Büyük bilet öğe olsa (en azından benim kitabımda) dil özgü deyimleri takip etmektir. Yakut ve Scala: Örneğin, ben daha aşina olduğum iki dilde bir REST API uygulama olduğunu varsayalım. Ruby versiyon yöntemini içeren bir sınıf MyCompany::Foo
olabilir bar_baz()
. Bunun tersine, aynı API versiyonu Scala bir yöntem ile bir sınıf com.mycompany.rest.Foo
olurdu barBaz()
. Bu sadece adlandırma, ama ben uzun bir yol tasarımı başka bir yerde oluşturulduğu bile, belirli bir dilde "evde" hissetmek için API yardımcı gider bulabilirsiniz.
Belge, doküman, belge: bunun ötesinde ben tavsiye sadece bir parça var. Bu kolay bir çoklu-uygulama API spec ile uğraşırken aklı tutmak için en iyi yoldur.