API࢓༷ॻΛ ͍͍ײ͡ʹ؅ཧ͢Δ potatotips #28 yuyakaido

ࣗݾ঺հ • ւ౻༏໻ʢ͔͍Ͳ͏Ώ͏΍ʣ • גࣜձࣾΤ΢ϨΧ • ໿1೥ͷΠϯλʔϯΛܦͯɺ2015೥4݄ʹ৽ଔೖࣾ • AndroidͷνʔϜϦʔμʔ • ςετ͓͡͞Μ yuyakaido yuyakaido

גࣜձࣾΤ΢ϨΧ • ࣗࣾαʔϏεͷاըɾ։ൃɾӡӦ • ΦϯϥΠϯσʔςΟϯάαʔϏεɿ • Χοϓϧઐ༻ΞϓϦɿ • ࣾһ਺ɿ104໊ • IAC ΤϯδχΞ 51 ඇΤϯδχΞ 53

API࢓༷ॻ Ͳ͏΍ͬͯ؅ཧͯ͠·͔͢ʁ

Α͋͘Δྫ • GitHub Wiki • Google Spreadsheet Ϩεϙϯε͕࢓༷ॻͱҧ͏Μ͚ͩͲ σϓϩΠ଴ͪͰ։ൃετοϓ ୭΋ϝϯς͠ͳ͍໰୊ ςετίʔυͱ࢓༷ॻ͕ζϨ͍ͯΔ໰୊ Wiki͸ͳΜͱͳ͘ςϯγϣϯ্͕͕Βͳ͍

• Apiary • Swagger

Apiary • https://apiary.io/ • MarkdownͬΆ͍ײ͡Ͱهड़ • ਖ਼֬ʹ͸ɺAPI Blueprint • ϞοΫαʔόʔͷੜ੒΋Մೳ

Apiary

Swagger • http://swagger.io/ • YAMLͬΆ͍ײ͡Ͱهड़ • ਖ਼֬ʹ͸ɺOpen API • ϞοΫαʔόʔͷੜ੒΋Մೳ

Swagger

Apiary or Swagger • Swagger͸ΫϥΠΞϯτίʔυͷੜ੒͕ग़དྷΔ • Google΍MicrosoftͳͲ͕SwaggerΛϕʔεʹ Open API InitiativeΛൃ଍ • Swagger͕ࠓޙελϯμʔυʹͳ͍ͬͯ͘ʁ

Swagger • YAMLͰAPI࢓༷Λهड़ • ϞοΫαʔόʔΛੜ੒ • ΫϥΠΞϯτίʔυΛੜ੒

ϞοΫαʔόʔ • API࢓༷ॻ͑͞هड़͢Ε͹ɺαʔόʔͷ࣮૷Λ ଴ͨͣʹΫϥΠΞϯτ΋࣮૷Մೳ • ϞοΫαʔόʔΛ࢖ͬͨςετ

ΫϥΠΞϯτίʔυ • ϨεϙϯεͷೖΕ෺Ϋϥε GET /items {
 "items": [
 {
 "id": 0,
 "name": "foo",
 }, {
 "id": 1,
 "name": "bar",
 }
 ]
 } public class ItemResponse {
 
 @SerializedName("items")
 public List items;
 
 public static class Item {
 @SerializedName("id")
 public Long id;
 @SerializedName("name")
 public String name;
 }
 
 } ItemResponse

·ͱΊ • Wiki΍SpreadsheetͰͷAPI࢓༷ॻ؅ཧ͸ ͪΐͬͱਏ͍ • Apiary΍SwaggerΛ࢖͏ͱ޾ͤʹͳΕΔ • Swagger͕ࠓޙͷελϯμʔυʹͳΔ͔΋͠ Εͳ͍

Thank you :) Credit: NASA Earth Observatory/NOAA NGDC