potatotips-28

Transcript

1. API࢓༷ॻΛ ͍͍ײ͡ʹ؅ཧ͢Δ potatotips #28 yuyakaido
2. ࣗݾ঺հ • ւ౻༏໻ʢ͔͍Ͳ͏Ώ͏΍ʣ • גࣜձࣾΤ΢ϨΧ • ໿1೥ͷΠϯλʔϯΛܦͯɺ2015೥4݄ʹ৽ଔೖࣾ • AndroidͷνʔϜϦʔμʔ • ςετ͓͡͞Μ  yuyakaido yuyakaido
3. גࣜձࣾΤ΢ϨΧ • ࣗࣾαʔϏεͷاըɾ։ൃɾӡӦ • ΦϯϥΠϯσʔςΟϯάαʔϏεɿ • Χοϓϧઐ༻ΞϓϦɿ • ࣾһ਺ɿ104໊ • IAC  ΤϯδχΞ 51 ඇΤϯδχΞ 53
4. API࢓༷ॻ Ͳ͏΍ͬͯ؅ཧͯ͠·͔͢ʁ 
5. Α͋͘Δྫ • GitHub Wiki • Google Spreadsheet  Ϩεϙϯε͕࢓༷ॻͱҧ͏Μ͚ͩͲ σϓϩΠ଴ͪͰ։ൃετοϓ ୭΋ϝϯς͠ͳ͍໰୊ ςετίʔυͱ࢓༷ॻ͕ζϨ͍ͯΔ໰୊ Wiki͸ͳΜͱͳ͘ςϯγϣϯ্͕͕Βͳ͍
6. • Apiary • Swagger 
7. Apiary • https://apiary.io/ • MarkdownͬΆ͍ײ͡Ͱهड़ • ਖ਼֬ʹ͸ɺAPI Blueprint • ϞοΫαʔόʔͷੜ੒΋Մೳ 
8. Apiary 
9. Swagger • http://swagger.io/ • YAMLͬΆ͍ײ͡Ͱهड़ • ਖ਼֬ʹ͸ɺOpen API • ϞοΫαʔόʔͷੜ੒΋Մೳ 
10. Swagger 
11. Apiary or Swagger • Swagger͸ΫϥΠΞϯτίʔυͷੜ੒͕ग़དྷΔ • Google΍MicrosoftͳͲ͕SwaggerΛϕʔεʹ Open API InitiativeΛൃ଍ • Swagger͕ࠓޙελϯμʔυʹͳ͍ͬͯ͘ʁ 
12. Swagger • YAMLͰAPI࢓༷Λهड़ • ϞοΫαʔόʔΛੜ੒ • ΫϥΠΞϯτίʔυΛੜ੒ 
13. ϞοΫαʔόʔ • API࢓༷ॻ͑͞هड़͢Ε͹ɺαʔόʔͷ࣮૷Λ ଴ͨͣʹΫϥΠΞϯτ΋࣮૷Մೳ • ϞοΫαʔόʔΛ࢖ͬͨςετ 
14. ΫϥΠΞϯτίʔυ • ϨεϙϯεͷೖΕ෺Ϋϥε  GET /items {
 "items": [
 {
 "id": 0,
 "name": "foo",
 }, {
 "id": 1,
 "name": "bar",
 }
 ]
 } public class ItemResponse {
 
 @SerializedName("items")
 public List<Item> items;
 
 public static class Item {
 @SerializedName("id")
 public Long id;
 @SerializedName("name")
 public String name;
 }
 
 } ItemResponse
15. ·ͱΊ • Wiki΍SpreadsheetͰͷAPI࢓༷ॻ؅ཧ͸ ͪΐͬͱਏ͍ • Apiary΍SwaggerΛ࢖͏ͱ޾ͤʹͳΕΔ • Swagger͕ࠓޙͷελϯμʔυʹͳΔ͔΋͠ Εͳ͍ 
16. Thank you :) Credit: NASA Earth Observatory/NOAA NGDC