SDK

箱を開けるとすでに切ってあります

サービスに一回リクエストを送るには、かなり手間がかかります。住所を正確に書き、鍵を規格どおりに付け、送る内容を決まった形に包み、返ってきた答えの塊から必要な部分だけ取り出さなければなりません。ここに答えが長いときの受け取り処理、失敗したときの再送処理まで加わると、仕事がさらに増えます。

キットはこの過程を部品一つにあらかじめまとめておきます。インストールを一度して部品の名前を呼べば、中でリクエストを組んで送り、答えを整えて返してくれます。最初の接続にかかっていた時間が、半日から数分に縮まるわけです。

細かな作業を代わりにしてくれる点が特に大きいです。しばらく途切れたときにやり直すこと、順番どおりに届かない断片をつなぎ合わせることは、自分で組むとミスが出やすいですが、キットにはすでに検証された方式で入っています。

箱ごとに説明書が入っています

キットには部品だけがあるのではありません。どの部品をどんな順序ではめるか書いた文書と、そのままなぞれば動く例が一緒に入っています。初めて付ける人は、例を一つコピーして自分の内容だけ書き換えるところから始めます。

部品が全部必要なわけでもありません。会話機能だけ使う人にとって、画像や音声の部品は箱の中にそのまま残ります。余った部品があっても問題にはなりませんが、プログラムが重くなるのが気になるなら、必要な部分だけ選んで入れられるキットを選ぶこともあります。

木の種類ごとに箱が違います

同じ本棚でも無垢材用と合板用で部品が違うように、キットもプログラムを作る言語ごとに別々に出ます。表向きにすることは同じでも、部品の名前とはめ方は言語の習慣に沿っています。

だから同じサービスを使うにしても、チームが使う言語に合った箱を選ばなければなりません。箱がない言語なら、規格に合わせて自分でリクエストを作るか、他の人が作っておいた非公式のキットを使うことになります。非公式のキットはサービスが変わったとき一緒に手直ししてくれる人がいないこともあるので、選ぶ前に最近も手入れされているか確かめるのがよいです。

箱にない形は自分で切らないといけません

新しい機能が出ると、規格には先に開かれてキットには少し遅れて入ることがよくあります。こんなときはキットを使いながらも、その機能だけは規格に合わせて自分でリクエストを送ります。キットが規格を包んだ皮であると分かっていれば、この迂回は難しくありません。

版を上げることも忘れてはいけません。古いキットをそのまま使うと、新機能が使えないだけでなく、サービス側が古い方式を閉じたときにある日突然接続が切れることもあります。版を上げるとき部品の名前が変わることもあるので、変更点を書いた案内文を先に読んでから移すほうが安全です。