外部APIとズブズブな開発どうしてますか？

by kin29

Slide 1

Slide 1 text

外部APIとズブズブな開発どうしてますか？志賀彩乃(@kin29ma_n)

Slide 2

Slide 2 text

自己紹介 ● 志賀彩乃(@kin29ma_n) ● 株式会社カルテットコミュニケーションズ ○ 愛知県名古屋市 ○ PHPer大募集中です ○ 会社に入ってSymfonyはじめました ● 趣味: ペチコン/PHPerKaigi行くこと ● 息子(3) ● 山口→ 宮崎 → 愛知

Slide 3

Slide 3 text

話すこと ● API → Web API ● 外部APIを使う上での失敗とその対処法 ○ あるある①: APIアップデートのキャッチアップ漏れ ○ あるある②: APIリファレンスに情報が載ってない ○ あるある③: 急にAPIやエンドポイントが使えなくなる話さないこと󰢄 ● 外部APIの使用方法 ● PHPな話

Slide 4

Slide 4 text

ではさっそくこれがベストだと思っていないので、良い方法があればぜひ教えてください🙇🙇🙇

Slide 5

Slide 5 text

外部APIを使う上でのあるあるな失敗とその対処法 ● あるある①: APIアップデートのキャッチアップ漏れ 👈 ● あるある②: APIリファレンスに情報が載ってない ● あるある③: 急にAPIやエンドポイントが使用不可になる

Slide 6

Slide 6 text

あるある①: APIアップデートのキャッチアップ漏れ BEFORE 約10個の媒体APIのアップデート情報のキャッチアップを、 1人のスーパー開発者に依存していました。＼本当にありがとうございました 🙇／・G⚫ogle ・Yah⚫o Search ・Yah⚫o Display ・M⚫ta ・旧T⚫itter ・L⚫NE ・TikT⚫k ・S⚫rtNews ・Micr⚫Soft ・fre⚫e ・G⚫ogle Analytics

Slide 7

Slide 7 text

あるある①: APIアップデートのキャッチアップ漏れ AFTER 約10個の媒体APIのアップデート情報のキャッチアップを、月に1回、3人で行う（=1人あたり3~4個）・Yah⚫o Search ・旧T⚫itter ・S⚫art News ・Tikt⚫k ・G⚫ogle ・L⚫NE ・Micr⚫Soft ・Yah⚫o Display ・M⚫ta ・G⚫ogle Analytics ・fre⚫e

Slide 8

Slide 8 text

あるある①: APIアップデートのキャッチアップ漏れ具体的な方法 ● 新しいAPIバージョンがでていれば、GitHub Issuesを立てる ○ キャッチアップの方法 ■ リリースノート（RSSフィード） ■ メール ■ → 専用Slackチャンネルに流す ● 廃止日やサポート終了日が近いものは優先度高めで対応する

Slide 9

Slide 9 text

外部APIを使う上でのあるあるな失敗とその対処法 ● あるある①: APIアップデートのキャッチアップ漏れ ● あるある②: APIリファレンスに情報が載ってない 👈 ● あるある③: 急にAPIやエンドポイントが使用不可になる

Slide 10

Slide 10 text

あるある②: APIリファレンスに情報が載ってない動画(VIDEO)の時のレスポンスしか分からない。画像の時のレスポンスが知りたい！

Slide 11

Slide 11 text

あるある②: APIリファレンスに情報が載ってない対処法 ● APIを叩く(cURL, Postman等) ● 実際にそのAPIを使っているであろう画面にて、デベロッパーツールでリクエスト/レスポンスを見る

Slide 12

Slide 12 text

あるある②: APIリファレンスに情報が載ってない対処法 ● APIを叩く(cURL, Postman等) ● 実際にそのAPIを使っているであろう画面にて、デベロッパーツールでリクエスト/レスポンスを見る👈

Slide 13

Slide 13 text

あるある②: APIリファレンスに情報が載ってない対処法 ● APIを叩く(cURL, Postman, API Tester等) ● 実際にそのAPIを使っているであろう画面にて、デベロッパーツールでリクエスト/レスポンスを見る👈 ○ ①実際にそのAPIを使っているであろう画面の目星をつける ○ ②デベロッパーツール > ネットワークを開く ○ ③該当APIエンドポイント（または似ているもの）を見つけ、リクエスト/レスポンスを見る

Slide 14

Slide 14 text

あるある②: APIリファレンスに情報が載ってない ①実際にそのAPIを使っているであろう画面の目星をつける例）静止画の編集画面、静止画を表示させている画面など＼推理力／

Slide 15

Slide 15 text

あるある②: APIリファレンスに情報が載ってない ②デベロッパーツール > ネットワークを開く

Slide 16

Slide 16 text

あるある②: APIリファレンスに情報が載ってない ③該当APIエンドポイントを見つけ、リクエスト/レスポンスを見る

Slide 17

Slide 17 text

あるある②: APIリファレンスに情報が載ってない ③該当APIエンドポイントを見つけ、リクエスト/レスポンスを見る＼静止画の時のレスポンスも把握できた🎉／

Slide 18

Slide 18 text

外部APIを使う上でのあるあるな失敗とその対処法 ● あるある①: APIアップデートのキャッチアップ漏れ ● あるある②: APIリファレンスに情報が載ってない ● あるある③: 急にAPIエンドポイントが使用不可になる 👈

Slide 19

Slide 19 text

あるある③: 急にAPIエンドポイントが使用不可になる直近でほんとにあった怖い話「〇〇の機能が使えません」というお問い合わせをいただく →原因調査すると、昨日まで使えてたAPIエンドポイントが急に使えなくなっていた。

Slide 20

Slide 20 text

あるある③: 急にAPIやエンドポイントが使用不可になる対処法 ● 防ぐことは難しい ● 発生した時の解決法 ○ ログを見る → 「エラーメッセージ」を読む ○ 「エラーメッセージ」でググる ■ 公式のリリースノートやAPIリファレンス ■ 媒体のフォーラム ■ GitHub Issues ■ 個人サイトの記事 ○ ChatGPTに聞く

Slide 21

Slide 21 text

あるある③: 急にAPIやエンドポイントが使用不可になる対処法 ● 防ぐことは難しい ● 発生した時の解決法 ○ ログを見る → 「エラーメッセージ」を読む ○ 「エラーメッセージ」でググる ■ 公式のリリースノートやAPIリファレンス ■ 媒体のフォーラム 👈 ■ GitHub Issues ■ 個人サイトの記事 ○ ChatGPTに聞く

Slide 22

Slide 22 text

あるある③: 急にAPIやエンドポイントが使用不可になる媒体のフォーラムにて同じ状況&解決方法を記載してくれてる方がいた →無事解決しました🎉🎉🎉 ＼超感謝😭！！！／

Slide 23

Slide 23 text

まとめ ● APIとズブズブなのは手がかかる ● APIがないと作れない機能がある ○ APIを提供してくれて、ありがとう！ ● 困った時に助けてくれる人はいる！ ○ 情報提供してくれた人に感謝を伝えよう！

Slide 24

Slide 24 text

まとめ ● APIとズブズブなのは手がかかる ● APIがないと作れない機能がある ○ API提供してくれて、ありがとう！ ● 困った時に助けてくれる人はいる！ ○ 情報提供してくれた人に感謝を伝えよう！助け合いの世界🤝

Slide 25

Slide 25 text

助けてくれる or 助け合いたいPHPerの方、大募集中です🙌🙌🙌 https://quartetcom.co.jp/recruit/engineer/

Slide 26

Slide 26 text

ご清聴ありがとうございました。みなさまのAPI攻略法の共有お待ちしています。