API アクセス:自分のプログラムからデータを読む
あなたのウェブサイトが次のイベントを表示し、表計算ソフトが月の合計を出し、会館のスクリーンが行事を一覧にする。こうした機能がないと、誰かがそれらを手で写すことになります。API アクセスがあれば、それぞれのプログラムが独自のキーを受け取り、許可されたものだけを読みます。それ以上は読めません。
- 団体のメニューからAPI アクセスを開き、新しいキーをタップします。
- 何のためかを書き(例:「ウェブサイト」)、何を読めるかにチェックを入れます。各チェックの下に、何が出て何が出ないかが表示されます。
- 支部がある場合は、団体全体か一つの支部を選びます。有効期間も選びます:オフにするまで、90 日、または一年。
- キーを作成をタップします。今すぐキーをコピーして、そのプログラムの担当者に渡してください。表示されるのは一度だけです。
- ページには、各キーが最後に使われた日時と、その頻度が表示されます。停止を押すと、すぐにそのキーが止まります。
キーは読むことだけができます。このキーでは、何も変更や削除はできません。
ウェブサイトのフォーム(送信用):キーに、三つのこと(それぞれ担当者の承認を待ちます)を送信することも許可できます:参加の申し込み(「参加する」フォームから。団体の参加リンクと同様に、承認されるまで待ちます)、メッセージ(「お問い合わせ」フォームから。団体のウェブサイトのメッセージと一緒に届きます)、ニュースレターの登録(本人がまずメールで確認する必要があります)。これらは何を送信できるか?の下で個別にチェックします。チェックしなければ、キーは何も送信できません。キーごとに、1 分あたり 10 件、1 日 500 件まで送れます。送られた内容はすべて操作履歴に記録されます。
こうしたフォームをウェブサイトに置く前に:フォームで、入力された情報がどこに送られるかを人に伝え、同意してもらってください。プログラムは同意があったことを送信しなければならず、そうでない場合は拒否されます。参加の申し込みは、団体の参加リンクが開いている間のみ受け付けられ、ニュースレターの登録は、登録が開いている間のみ受け付けられます。
キーに読ませてよいもの:団体について、メンバー、委員会、支部、メンバーの名簿、会議、イベント、掲示板、タスク、プロジェクト、計画、お金、請求書と支払請求書、資産、メディアライブラリ、ニュースレター、証明書、年次報告書、レポートの数字。また、数字だけで名前は一切含まないもの:カレンダー(日付のあるものすべてを一覧にしたもの)、会員の種類と会費、各会議の出席人数、各イベントの参加人数と残りの枠、まだボランティアが必要な当番、各募金の呼びかけで集まった金額、締め切られた投票の結果、そして施行中の規程。団体が持っているものだけが見えます。
支部のキーは、その支部と、その下にあるものだけを読めます。団体全体のもの(団体について、レポートの数字など)は渡されません。
期限が切れるキーは、期限の日に自動的に止まるため、忘れられたキーがいつまでも動くことはありません。管理者には、一週間前に通知とメールが届きます。新しいキーを作り、期限までにプログラムに入れてください。
決して渡さないもの:メンバーについてのメモ、誕生日、自宅の住所。オンライン会議のリンクとコード。個人情報が消去されたメンバーに関するすべて。公開していないイベント、プロジェクト、計画。タスクのメモ。資産の価値と管理者。ニュースレターの購読者。アルバムの写真。人の名前を含むレポートの表。請求書の下書きと顧客の住所。
プログラムを接続する人へ:ページの下部に、アドレス、例、取得できるもの、制限(キーごとに 1 分あたり 60 件、1 ページ最大 100 行)が表示されます。
キーはパスワードと同じように扱ってください。メンバーを読めるキーは、個人の情報を渡すことになります。信頼できるプログラムにのみ渡し、プライバシーの通知にもそう書いてください。キーが誤った人の手に渡った可能性がある場合は、停止して新しいキーを作ってください。停止したキーは、再びオンにすることはできません。