はてなリモートインターン2021 Web API 講義資料

https://hatenacorp.jp/recruit/intern/2021

Transcript

1. Web API IBUFOBJOUFSO
2. ׆ס铺紶ךע ˝ )551 ˝ 3&45 ˝ (SBQI2- ˝ H31$
3. "1* "QQMJDBUJPO
   1SPHSBNNJOH
   *OUFSGBDF ˝ HMJCD ˝ document.getElementById ˝ GET https:!"api.twitter.com/1.1/statuses/ show.json?id=210462857140252672
4. )551 )ZQFSUFYU
   5SBOTGFS
   1SPUPDPM
5. )551סذّؕٚؕ٤  )551  )551  )551  (PPHMFֿ41%:؅ 氦辐  (PPHMFֿ26*$؅ 氦辐  41%:؅⩕מ׊ג)551ס嘅嶖⴫  )551PWFS26*$؅)551מ䷉ ⺲  26*$ס嘅嶖⴫
6. )551 ˝ 3'$
   
   )ZQFSUFYU
   5SBOTGFS
   1SPUPDPM
   
   )551 ˝ 3'$
   
   )ZQFSUFYU
   5SBOTGFS
   1SPUPDPM
   
   )551 ˝ 3'$
   
   )ZQFSUFYU
   5SBOTGFS
   1SPUPDPM
   )551 
   .FTTBHF
   4ZOUBY
   BOE
   3PVUJOH ˝ 3'$
   
   )ZQFSUFYU
   5SBOTGFS
   1SPUPDPM
   )551 
   4FNBOUJDT
   BOE
   $POUFOU ˝ 3'$
   
   )ZQFSUFYU
   5SBOTGFS
   1SPUPDPM
   )551 
   $POEJUJPOBM
   3FRVFTUT ˝ 3'$
   
   )ZQFSUFYU
   5SBOTGFS
   1SPUPDPM
   )551 
   3BOHF
   3FRVFTUT ˝ 3'$
   
   )ZQFSUFYU
   5SBOTGFS
   1SPUPDPM
   )551 
   $BDIJOH ˝ 3'$
   
   )ZQFSUFYU
   5SBOTGFS
   1SPUPDPM
   )551 
   "VUIFOUJDBUJPO
7. )551סجُ٤طؔؠت ˝ ْخشغכذ٭أشعٛؠؙتع ˝ تط٭ذتٝتَ٤ت ˝ ىشر٭ ˝ ٍظؔ
8. 63- 6OJGPSN
   3FTPVSDF
   -PDBUPS https:!"localhost:8000/search?q=text#hello εΩʔϜ:!"ϗετ:ϙʔτ/ύε?ΫΤϦ#ϑϥάϝϯτ 
   8)"58(
   63-
   -JWJOH
   4UBOEBSE
9. /FUDBUך)551ٛؠؙتع $ nc www.hatena.ne.jp 80 !" EOF GET / HTTP/1.1 Host: www.hatena.ne.jp EOF
10. HTTP/1.1 301 Moved Permanently Server: awselb/2.0 Date: Mon, 03 Aug 2020 01:58:38 GMT Content-Type: text/html Content-Length: 150 Connection: keep-alive Location: https:!"www.hatena.ne.jp:443/ <html> <head><title>301 Moved Permanently!#title>!#head> <body bgcolor="white"> <center><h1>301 Moved Permanently!#h1>!#center> !#body> !#html>
11. 5-4ך䫘禈׊י)551ٛؠؙتع $ openssl s_client -connect www.hatena.ne.jp:443 HEAD / HTTP/1.1 Host: www.hatena.ne.jp
12. )551 ٛؠؙتع METHOD target HTTP/1.1 Header: Value body ٝتَ٤ت HTTP/1.1 000 Reason Header: Value body
13. ٛؠؙتع车 METHOD target HTTP/1.1 GET POST PUT HEAD DELETE OPTIONS TRACE CONNECT PATCH / /search?q=text HTTP/1.0 HTTP/1.1
14. ىشر٭ Host: www.hatena.ne.jp
15. تط٭ذت车 HTTP/1.1 000 Reason ˝ 1xx
    *OGPSNBUJPOBM ˝ 2xx
    4VDDFTTGVM ˝ 3xx
    3FEJSFDUJPO ˝ 4xx
    $MJFOU
    &SSPS ˝ 5xx
    4FSWFS
    &SSPS
16. ٍظؔ ˝ Content-Type: text/html
    ˒
    )5.- ˝ Content-Type: application/JSON
    ˒
    +40/ ˝ Content-Type: application/x-www-form-urlencoded key=value&another_key=another_value
17. ٍظؔס㏆竊 Accept-Encoding: gzip, deflate Content-Encoding: gzip ˝ gzip ˝ compress ˝ deflate ˝ identity ˝ br
18. )551 3'$
    
    )ZQFSUFYU
    5SBOTGFS
    1SPUPDPM
    7FSTJPO
    
    )551
19. )551 ˝ 㓹儖氳םجُ٤طؔؠتע㚺؂׼םַ ˝ فؕػٛך׷׽כ׽׌׾ ˝ ץכחס5$1ؤؾؠب٘٤؅♞䘶氳מ邾丗סتعٛ٭ّמ⮆Ⱏ ׌׾ ˝ تعٛ٭ّס╈ךنٝ٭ّ؅׷׽⹦׽׌׾ ˝ تعٛ٭ّס⨣⩝䈱׷❣㰆꞊➟׵辐杯ך׀׾
20. نٝ٭ّ +-----------------------------------------------+ | Length (24) | +---------------+---------------+---------------+ | Type (8) | Flags (8) | +-+-------------+---------------+-------------------------------+ |R| Stream Identifier (31) | +=+=============================================================+ | Frame Payload (0!!") !!" +---------------------------------------------------------------+ 
    )ZQFSUFYU
    5SBOTGFS
    1SPUPDPM
    7FSTJPO
    
    )551
    
    'SBNF
    'PSNBU
21. %"5"نٝ٭ّ0x0 +---------------+ |Pad Length? (8)| +---------------+-----------------------------------------------+ | Data (*) !!" +---------------------------------------------------------------+ | Padding (*) !!" +---------------------------------------------------------------+ END_STREAM
    0x1
    ]
    PADDED
    0x8
22. )&"%&34نٝ٭ّ0x1 +---------------+ |Pad Length? (8)| +-+-------------+-----------------------------------------------+ |E| Stream Dependency? (31) | +-+-------------+-----------------------------------------------+ | Weight? (8) | +-+-------------+-----------------------------------------------+ | Header Block Fragment (*) !!" +---------------------------------------------------------------+ | Padding (*) !!" +---------------------------------------------------------------+ END_STREAM
    0x1
    ]
    END_HEADERS
    0x4
    ]
    PADDED
    0x8
    ]
    PRIORITY
    0x20
23. 橎⛍ىشر٭ ٛؠؙتع ˝ :method ˝ :authority ˝ :scheme ˝ :path ٝتَ٤ت ˝ :status
24. )1"$, 3'$
    
    )1"$,
    )FBEFS
    $PNQSFTTJPO
    GPS
    )551 ˝ ـنُ٤瑞⺘ ˝ ꪐ氳ط٭هٜ ˝ Ⳃ氳ط٭هٜ
25. *OEFY )FBEFS
    /BNF )FBEFS
    7BMVF  :authority  :method GET  :method POST  :path /  :path /index.html  :scheme http  :scheme https  :status 200
26. )551 ˝ )551סجُ٤طؔؠت؅禴䧏 ˝ ץכחס5$1ؤؾؠب٘٤؅邾丗סتعٛ٭ّמ⮆Ⱏ ˝ 邾丗סٛخ٭ت؅┉䈱מ׷׽⹦׽ך׀׾ ˝ 邾ꥭם⯆䐒ֿך׀׾ ˝ ىشر٭׵㏆竊
27. )551 ˝ 26*$عٚ٤تَ٭ع ˝ 6%1┕מ5$1כ5-4ס嚀耆؅⫋杯 ˝ )551PWFS26*$ ˝ )551؅26*$عٚ٤تَ٭ع┕ך㲔逷 ˝ ┘釐מםזג嚀耆؅⯡ꢜ ˝ 21"$,
28. )551
    PWFS
    26*$ ˝ 21"$, ˝ 瑞⺘⴫םלյ㓹儖ע)1"$,כ⺱׋ ˝ Ⳃ氳ط٭هٜס䣽ַ亠ס㚺催 ˝ ꪐ氳ط٭هٜס㵚䑴ىشر鴑ⱶ
29. 26*$ ˝ 3'$
    
    7FSTJPO*OEFQFOEFOU
    1SPQFSUJFT
    PG
    26*$ ˝ 3'$
    
    26*$
    "
    6%1#BTFE
    .VMUJQMFYFE
    BOE
    4FDVSF
    5SBOTQPSU ˝ 3'$
    
    6TJOH
    5-4
    UP
    4FDVSF
    26*$ ˝ 3'$
    
    26*$
    -PTT
    %FUFDUJPO
    BOE
    $POHFTUJPO
    $POUSPM
30. ج؞ٖؓם26*$ ˝ 5-4 ˝ 355ـ٤غبؘؕؠמ׻׾냕鵭⴫ &BSMZ
    %BUB ˝ 14, ◄⯥⪦鵟ꐶ ˝ ꐶס⫋⮵榫
31. ؤؾؠب٘٤ُؕءٝ٭ب٘٤ ˝ ⶡ┉סؾشع٠٭ؠقتמ䦔兠׈׿םַ ˝ ؙ٤غَؕ٤عסؓغٝت׷َ٭عֿ㚺催׈׿י׵䫘禈؅禴䧏 ך׀׾
32. ؓغٝتفٛظ٭ب٘٤ ˝ 鴜⟓⩕ؓغٝتֿ塜׊ַ׵ס־吾錞׌׾ ˝ عٚنؔشؠ㘃䆋䷍䱡 ؓ٤و䷍䱡 㵚瓀 ˝ 吾錞׈׿יַםַؓغٝتמ㵚׊יע鴜⟓ظ٭ذꄈ؅⯆꡾׌׾
33. )551 ˝ 6%1┕מ5$1 5-4؅㲔杯׌׾ ˝ )5514מ׻׾鵟⟓ֿ⯥䬠 ˝ 355מ׻׾Ⲗ曍⴫ ˝ /"5ٛفؕ٤ظؔ٤ءמ׻׾َ٭ع樑⺘㚺催םלֿ颯׀י׵䫘 禈ֿ禴䧏ך׀׾ ˝ ؓغٝت吾錞מ׻׾ؓ٤و䷍䱡㵚瓀
34. "1* "QQMJDBUJPO
    1SPHSBNNJOH
    *OUFSGBDF
35. -46%T
    -BSHF
    4FU
    PG
    6OLOPXO
    %FWFMPQFST ˝ 僃㛻⪜硜丗氳ם"1*؅䬠❠׌׾ 44,%T
    4NBMM
    4FU
    PG
    ,OPXO
    %FWFMPQFST ˝ ؠٚؕؓ٤عמ僃鸵⴫׊ג"1*؅䬠❠׌׾
36. 3&45 3FQSFTFOUBUJPOBM
    4UBUF
    5SBOTGFS ˝ )551ס☼磝ײ؅ֹױׂ✳ֹ ˝ ٛخ٭ت䧗⺸ https:!"api.github.com/repos/hatena/example/ issues/1
37. $36% )551ْخشغ $SFBUF POST 3FBE GET 6QEBUF PUT
    
    PATCH %FMFUF DELETE
38. (JU)VCסؕبٖ٭ؤْ٤ع ˝ GET /repos/:owner/:repo/issues/ comments/:comment_id ˝ POST /repos/:owner/:repo/issues/:issue_number/ comments ˝ PATCH /repos/:owner/:repo/issues/ comments/:comment_id ˝ DELETE /repos/:owner/:repo/issues/ comments/:comment_id
39. 0QFO"1* ˝ 4XBHHFS ˝ 3&45
    "1*؅鋗鳭׌׾ג״ס☼喋 ˝ ؤ٭غ榟䡗מ׵✳ֻ׾
40. (SBQI2- ˝ 'BDFCPPLמ׻זיꝧ氦׈׿ג ˝ ؠٚؕؓ٤ع⣐־׼䑒釐םنؔ٭ٜغ؅䧗㲊׌׾ ˝ ت؞٭ُ־׼סؤ٭غ榟䡗ֿך׀׾
41. 4%-
    4DIFNB
    %FOJUJPO
    -BOHVBHF interface Actor { login: String! } type Issue { author: Actor body: String! title: String! } type Repository { issue(number: Int!): Issue } type Query { repository(name: String!, owner: String!): Repository }
42. ؠؙٛ query GetFirstIssue { repository(name: "Hatena-Intern-2020", owner: "hatena") { issue(number: 1) { author { login } body title } } }
43. H31$
44. H31$
    PWFS
    )551 ˝ )551┕מ啶疣׈׿ג׵ס ˝ HEADERSنٝ٭ّ׷DATAنٝ٭ّ H31$
    8FC ˝ 8FCهٚؗا⺸ׄמ)551כ⮉׽ꦕ׊ג׵ס ˝ ئ٭ف٭⣐מ׵وٞ؞بֿ䑒釐
45. 1SPUPDPM
    #VFST ˝ 啶鵰⴫׈׿גظ٭ذ؅بٛؓٚؕث׌׾☼磝ײ ˝ فؕػٛنؚ٭ُشع ˝ *%-
    *OUFSGBDF
    %FTDSJQUJPO
    -BOHVBHF ˝ .protoنٜؒؕ ˝ 31$؅ئَ٭ع׊יַ׾
46. syntax = "proto3"; package account; service Account { rpc Signup(SignupRequest) returns (SignupReply); } message SignupRequest { string name = 1; string password = 2; } message SignupReply { string token = 1; }
47. ْشج٭ة㑔 message SignupRequest { string name = 1; string password = 2; } ϑΟʔϧυܕ ϑΟʔϧυ໊ = ϑΟʔϧυ൪߸; ˝ نؔ٭ٜغ樑⺘ֿꄆ釐 ˝ ױךעCZUF ˝ ע◀硜岷ײ
48. ت؜ٚ٭㑔 double float int32 int64 uint32 uint64 sint32 sint64 fixed32 fixed64 sfixed32 sfixed64 bool string bytes
49. repeated Result results = 1; map<string, Project> projects = 3; oneof test_oneof { string name = 4; SubMessage sub_message = 9; }
50. message SearchRequest { string query = 1; int32 page_number = 2; int32 result_per_page = 3; enum Corpus { UNIVERSAL = 0; WEB = 1; IMAGES = 2; LOCAL = 3; NEWS = 4; PRODUCTS = 5; VIDEO = 6; } Corpus corpus = 4; }
51. import "google/protobuf/any.proto"; message Message { google.protobuf.Any field = 1; } ˝ google.protobuf.Empty ˝ google.protobuf.Duration ˝ google.protobuf.Timestamp
52. ◍䬵䓪 ˝ نؔ٭ٜغ樑⺘ int32 old_field = 6 [deprecated = true]; reserved 2, 15, 9 to 11; reserved "foo", "bar";
53. ؛وب٘٤ option go_package = "github.com/hatena/example/pb"; enum EnumAllowingAlias { option allow_alias = true; UNKNOWN = 0; STARTED = 1; RUNNING = 1; } message Example { int32 old_field = 6 [deprecated = true]; }
54. ئ٭لتכتعٛ٭ّ service RouteGuide { rpc GetFeature(Point) returns (Feature) {} rpc ListFeatures(Rectangle) returns (stream Feature) {} rpc RecordRoute(stream Point) returns (RouteSummary) {} rpc RouteChat(stream RouteNote) returns (stream RouteNote) {} }
55. H31$מֽׄ׾"1*錃銶 $36%
    
    -JTU ˝ CreateEntity ˝ GetEntity ˝ UpdateEntity ˝ DeleteEntity ˝ ListEntities
56. $MPVE
    'VODUJPOTס❆ ˝ CallFunction ˝ CreateFunction ˝ GetFunction ˝ UpdateFunction ˝ DeleteFunction ˝ ListFunctions
57. H31$ئ٭ف٭؅⛼׾
58. syntax = "proto3"; option go_package = "./pb"; package welcome; service Welcome { rpc Greet(GreetRequest) returns (GreetReply); } message GreetRequest { string name = 1; } message GreetReply { string message = 1; }
59. 1SPUPDPM
    $PNQJMFS protoc $ # protoc ͸ brew install protobuf ΍ apt install protobuf-compiler ͳͲͰ $ go install google.golang.org/protobuf/cmd/protoc-gen-go $ go install google.golang.org/grpc/cmd/protoc-gen-go-grpc $ protoc !"go_out=. !"go-grpc_out=. welcome.proto
60. package main import ( "context" "flag" "fmt" "github.com/hatena/intern-grpc/pb" "google.golang.org/grpc" "google.golang.org/grpc/reflection" "log" "net" "os" "os/signal" ) var ( port = flag.Int("port", 10000, "The server port") )
61. type welcomeServer struct { pb.UnimplementedWelcomeServer } func (s *welcomeServer) Greet( ctx context.Context, req *pb.GreetRequest ) (*pb.GreetReply, error) { return &pb.GreetReply{ Message: fmt.Sprintf("Welcome %s", req.Name), }, nil } func newServer() *welcomeServer { return &welcomeServer{} }
62. func main() { lis, err !" net.Listen("tcp", fmt.Sprintf(":%d", *port)) if err !# nil { log.Fatalf("failed to listen: %v", err) } grpcServer !" grpc.NewServer() pb.RegisterWelcomeServer(grpcServer, newServer()) reflection.Register(grpcServer) go func() { log.Printf("start gRPC server port: %v", *port) grpcServer.Serve(lis) }() quit !" make(chan os.Signal) signal.Notify(quit, os.Interrupt) !$quit log.Printf("stopping gRPC server!!%") grpcServer.GracefulStop() }
63. -FU˖T
    USZ
    grpc_cli
64. grpc_cli $ docker run !"rm !"publish 10000:10000 hatena/intern-2020-grpc-adventure:latest $ docker run !"rm hatena/grpc_cli:latest ls host.docker.internal:10000 -l
65. grpc_cli $ grpc_cli ls localhost:10000 -l $ grpc_cli type localhost:10000 welcome.GreetRequest $ grpc_cli call localhost:10000 welcome.Welcome.Greet 'name: "John Appleseed"'