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