Jekyll.FAQ開発者向けAPIについてのよくある質問です。kickflow自体についてのFAQはこちら。Tokenのどちらを使用すべきでしょうか?APIのレスポンスに、API仕様書に記載のないフィールドが含まれているのですが、これは参照してもよいですか?チケットAPIについてのFAQチケットのJSONから、特定のフォームフィールドの入力を取得する方法を教えて下さいワークフローはkickflow内部でバージョン管理されているため、管理者がワークフローを編集する度に内部のフォームのidが変わります。代わりに、codeというワークフローの編集をまたいで不変のキーが存在しておりますので、こちらを軸に入力を取得してください。以下の手順で指定したフィールドの入力を取得できます。対象のフォームフィールドのcodeから、フォームフィールドのidを取得します。APIで確認できます。チケットの入力値の配列inputsから、formFieldIdが1で取得したidに一致するものを取得します。チケットの作成・更新時に、ファイルを添付することができますか?パフォーマンス上の理由から、現在エンタープライズプランのお客様のみ添付ファイルのアップロードAPIを利用可能です。チケットの作成APIのリクエストボディに詰めてください。チケットの作成・更新時に、リクエストボディ内の自動計算フィールドの入力には何を入力すればよいですか?自動計算フィールドの値はサーバー側で計算されるため、リクエストボディ内の入力値はnullでかまいません。リクエストボディ内のフォーム入力inputsには、自動計算フィールドを含むすべてのフィールドを指定する必要があるため、自動計算フィールドに対応する入力オブジェクトを省略することはできないのでご注意ください。Tokenを利用したAPI連携を実装することで可能です。コメントAPIについてのFAQメンションはどのようなフォーマットで投稿すればよいですか?コメントの本文内に、<@メンションしたいユーザーのUUID>という形式でメンションできます。以下のように表示され、山田太郎さんにメンションの通知が送信されます。文字はそれぞれ以下のコードにエスケープされ、X-Kickflow-Signatureを算出する際は、エスケープされた状態の文字列でHMAC-SHA256を計算します。\u003eWebhookのペイロードとシークレットからHMAC-SHA256を計算する際に、上記の文字列をアンエスケープして計算するとX-Kickflow-Signatureと一致しなくなります。受信したペイロードをそのまま使用して計算した値とX-Kickflow-Signatureを比較してください。Tokenの使用を優先してください。Tokenに比べてアクセスできる範囲がはるかに大きいため、万が一トークンが漏洩したときに影響範囲が大きくなります。Tokenを利用せざるを得ない例として、「外部サービスでユーザーが何らかの操作を行ったときに、自動的にkickflow内でそのユーザーがチケットを申請する」といった連携が挙げられます。Tokenを使用するだけで実現可能です。Tokenを使用して外部と連携する場合でも、トークンを発行するユーザーアカウントには必要最低限の権限のみを付与することをおすすめします。普段実際の社員が使うユーザーアカウントとは別に、連携に必要な権限のみを付与した連携専用のユーザーアカウントを用意することも検討してください。APIのレスポンスに、API仕様書に記載のないフィールドが含まれているのですが、これは参照してもよいですか?APIのレスポンスには、仕様書に記載のないフィールドが含まれる場合があります。したフィールドは動作保証対象外となります。事前の予告なくフィールドが変更・削除される恐れがあるため、参照しないようにしてください。