[JAWS-SG#02] 個人開発やハッカソンで役立つ、便利APIのつくりかた

Transcript

1. 個人開発やハッカソンで役立つ、 便利 API のつくりかた Kindai University / Hack’z Inc. Keisuke Mori
2. Keisuke Mori 近畿大学産業理工学部（福岡キャンパス） - 情報学科 4回生 - 暗号技術, ブロックチェーン, プライバシー技術 - ソフトウェア開発の演習では Cloud9 使ってました @moririn772 サーバーサイド／インフラ系 - Go, Ruby, AWS がお気に入り - JAWS-SG 運営メンバー（今日は配信担当）
3. ݸਓ։ൃ΍ϋοΧιϯͰ໾ཱͭɺศར API ͷͭ͘Γ͔ͨ Today’s TALK
4. ΰʔϧσϯ΢ΟʔΫɺԿͯ͠·͔ͨ͠ʁ Q.
5. A. ΦϯϥΠϯϋοΧιϯʹग़ͯ·ͨ͠ https://connpass.com/event/174573/ɹ
6. ͳʹ࡞ͬͨΜͰ͔͢ ☺☺ Q.
7. A. ͜Μͳ΋ͷΛ࡞Γ·ͨ͠
8. 作った背景テンプレートをタグ付けしてみんなに共有 （タグを付けて検索しやすく） A. ࡞ͬͨςϯϓϨʔτ͸ڞ༗Ͱ͖·͢
9. Ͳ͏΍ͬͯ࡞ͬͨΜͰ͔͢ Q.
10. A. ͜Μͳײ͡Ͱ࡞Γ·ͨ͠ Application Server Image Hosting Service Client Tag Suggestion Service API Gateway Lambda Translate Recognition Cloud SQL ( MySQL ) Cloudfront S3 React (Next) CI/CD etc… GAE ( Go ) Ұ෦ϋοΧιϯظؒ಺ʹऴΘΓ·ͤΜͰͨ͠…
11. ࠓ೔͸͜͜ͷ࿩Λ͠·͢ʂ Application Server Image Hosting Service Client Tag Suggestion Service API Gateway Lambda Translate Recognition Cloud SQL ( MySQL ) Cloudfront S3 React (Next) CI/CD etc… GAE ( Go )
12. ࢖ͬͨ AWS ͷαʔϏε Amazon API Gateway Amazon Rekognition AWS Lambda Amazon Translate ؆୯ʹ API ͷ࡞੒, ެ։, อक, ϞχλϦϯά, อޢΛߦ͏͜ͱ͕ Ͱ͖Δ αʔόʔϨε࣮ߦ؀ڥ ͍ΖΜͳݴޠͰॻ͚Δ Ruby, Go, Python, Java … ػցֶशͷઐ໳஌ࣝΛඞཁͱͤͣ ը૾΍ಈըͷ෺ମ, إ, γʔϯ Λ ಛఆͰ͖ΔɻΧελϜϥϕϧΛɹ ࢖͏ͱɺ෦඼ͷ෼ྨͳͲ΋Մೳ χϡʔϥϧػց຋༁αʔϏε 54 ݴޠʹରԠ
13. Tag Suggestion Service … 作った背景テンプレートをタグ付けして共有 → つけられそうなタグを背景画像から推測して提示する機能
14. Tag Suggestion Service … Tag Suggestion Service API Gateway Lambda Translate Recognition Client
15. Tag Suggestion Service … Tag Suggestion Service API Gateway Lambda Translate Recognition Client 背景に使われている素材（既にS3にPUT済）のURLを、 エンドポイントに投げる https://~~~/default/detect-image-label?image-uri=*************
16. Tag Suggestion Service … Tag Suggestion Service API Gateway Lambda Translate Rekognition Client API Gateway から Lambda に処理を流す。 Lambda関数（handrer.request_handler）を発火させ、 AWS-SDK から Rekognition のAPI を叩く。
17. Tag Suggestion Service … Tag Suggestion Service API Gateway Lambda Translate Rekognition Client Rekognition の “DetectLabels” オペレーションを使用。 画像をもとにラベルが検出され、結果が返る。
18. Tag Suggestion Service … Tag Suggestion Service API Gateway Lambda Translate Rekognition Client タグが英語で返ってきてしまい、UX的によくないので Amazon Translate の "Translate Text" オペレーションを 使用し、タグを 英語→日本語 に翻訳する。
19. Tag Suggestion Service … Tag Suggestion Service API Gateway Lambda Translate Rekognition Client これまでが処理の全貌 あとはクライアント側にレスポンスを返すだけ。 “body” : [ “飛行機”, “輸送”, “航空機”, “旅客機”, “車両” ]
20. Tag Suggestion Service … Tag Suggestion Service API Gateway Lambda Translate Rekognition Client 推測されたタグが表示される。 ユーザーはタグを選択し、テンプレートを公開する。
21. ͲΕ͘Β͍Ͱ࡞ͬͨΜͰ͔͢ ⏰ ⏰ Q.
22. A. 1࣌ؒ͘Β͍Ͱͭ͘Ε·ͨ͠ * ˎ ಈ࡞༏ઌͰ࡞ͬͨͷͰςετ͸ॻ͍ͯͳ͍͠ɺσϓϩΠ͸ZIPͰݻΊΔ΍Γํͩ͠ɺ ɹࡶ΍Μͬͯποίϛ͕ೖΓͦ͏Ͱ͕͢ಈ͘ͷͰϤγʂʂ ɹ ϋοΧιϯ΍ݸਓ։ൃ͸ʮಈ͘͜ͱʯ͕େ੾ͳͷͰʂʂʢݴ͍༁ʣ ɹ ͋ͱͰSAMͰ࡞Γ௚͠·͠ΐ͏…
23. ݸਓ։ൃ΍ϋοΧιϯͰ໾ཱͭɺศར API ͷͭ͘Γ͔ͨ ʙ Amazon Rekognition Λ࢖༻ͨ͠ը૾ͷλά෇͚APIฤ ʙ
24. ιʔείʔυ͸༧Ί༻ҙ͓͖ͯ͠·ͨ͠ $ git clone \ https://github.com/moririn772/tag-suggestion-api.git $ #ͱ͍͏ͷ͸ෆ਌੾ͳͷͰɺGitHubϦϙδτϦެ։ͯ͠·͢
25. Bundle install $ cd $ bundle install —path=vendor/bundle
26. Ͱ͖·ͨ͠ʂ $ ll > 5 13 10:47 Gemfile > 5 13 10:17 Gemfile.lock > 5 13 11:18 Readme.md > 5 13 10:49 handler.rb > 5 13 10:17 vendor
27. ZIPͰݻΊ·͢ $ zip -r handler.zip handler.rb vendor
28. ΆͪΆͪ…ʢLambdaʣ
29. ΆͪΆͪ…ʢAPI Gatewayʣ
30. ΆͪΆͪ…ʢIAMʣ
31. Ͱ͖…Δͷ͔…ʂʂ
33. ؆୯ʹ͜ͷϨϕϧͷػೳ͕࣮૷Ͱ͖Δͷ͘͢͝Ͷʁ
34. εϐʔυ࣮૷
35. ɹϚωʔδυαʔϏεΛͲΜͲΜ࢖͍ͬͯͬͯɺ ͍͍ײ͡ͷΞ΢τϓοτΛ͍ͯ͜͠͏
36. खΛಈ͔ͨ͠Βɺࠓ౓͸ͦΕΛ ొஃ΍ϒϩάͰΈΜͳʹγΣΞ͍ͯ͜͠͏
37. ݸਓ։ൃ΍ϋοΧιϯͰ໾ཱͭɺศར API ͷͭ͘Γ͔ͨ ʙ Amazon Rekognition Λ࢖༻ͨ͠ը૾ͷλά෇͚APIฤ ʙ Thank you !!
38. ͓·͚ɿίʔυղઆ
39. Gemfile Λฤूͯ͠ɺbundle install ͠·͢ # frozen_string_literal: true source 'https://rubygems.org' git_source(:github) { |repo_name| "https://github.com/#{repo_name}" } gem 'aws-sdk-rekognition' gem 'aws-sdk-translate' Gemfile $ bundle install —path=vendor/bundle
40. ґଘ gem Λ require ͠·͢ # frozen_string_literal: true require 'net/http' require 'json' require 'aws-sdk-rekognition' require 'aws-sdk-translate' require 'base64' require 'open-uri' def request_handler(event:, context:) image_uri = event['queryStringParameters']['image-uri'] resp = detect_label(URI.open(image_uri).read) { statusCode: 200, headers: { 'Content-Type': 'application/json' }, body: JSON.generate(resp) } end handler.rb
41. ґଘ gem Λ require ͠·͢ # frozen_string_literal: true require 'net/http' require 'json' require 'aws-sdk-rekognition' require 'aws-sdk-translate' require 'base64' require 'open-uri' handler.rb
42. Rekognition ʹϥϕϧΛ͚ͭͯ΋Β͏ؔ਺ def detect_label(data) client = Aws::Rekognition::Client.new attrs = { image: { bytes: data }, max_labels: 10 } response = client.detect_labels(attrs) # Filter labels = response.labels.select { |c| c.confidence >= 66 } # Translate tag, Generate response array labels.map { |l| translate(l[:name].downcase) } end handler.rb
43. ϥϕϧΛ೔ຊޠʹͯ͘͠ΕΔؔ਺ def translate(target) client = Aws::Translate::Client.new resp = client.translate_text( text: target, source_language_code: 'en', target_language_code: 'ja' ) resp.translated_text end handler.rb
44. ϦΫΤετͷϋϯυϥʔؔ਺Λ࣮૷͠·͢ def request_handler(event:, context:) # ΫΤϦύϥϝʔλ͸͜͏΍ͬͯऔΔ image_uri = event['queryStringParameters']['image-uri'] resp = detect_label(URI.open(image_uri).read) { statusCode: 200, headers: { 'Content-Type': 'application/json' }, body: JSON.generate(resp) } end handler.rb
45. DONE !!! def request_handler(event:, context:) # ΫΤϦύϥϝʔλ͸͜͏΍ͬͯऔΔ image_uri = event['queryStringParameters']['image-uri'] resp = detect_label(URI.open(image_uri).read) { statusCode: 200, headers: { 'Content-Type': 'application/json' }, body: JSON.generate(resp) } end handler.rb