On this page

フィルタリング API v3 の結果

API v3では、フィルターを使用して特定の結果を取得するオプションがあります。

チケット一覧を取得するための GET /tickets API のフィルターには特に制限があります。詳細および利用可能なすべてのオプションについては、こちらの記事をご参照ください。

シンプルフィルター

シンプルフィルターを使用すると、特定のカラムを指定した値で完全一致検索して結果を絞り込むことができます：

{"parameter":"value"}

このシンプルフィルターを使用すると、例えば「新規」ステータスのチケットを取得できます：

_filters:{"status":"N"}

また、条件をカンマで区切ることで複数の条件を組み合わせることもできます。例えば、特定のIDを持つ会社の男性連絡先をすべて検索する場合：

_filters={"gender":"M","company_id":"123abc"}

シンプルフィルターでは、パラメーターに対して特定の値のみを検索でき、演算子の定義や日付範囲の指定はできません。演算子の定義や日付範囲での検索には、アドバンスフィルターを使用してください。

アドバンス検索のフィルター形式では、シンプルフィルターの2つに対して3つの値が必要です：

[["parameter","operator","value"]]

ご覧のとおり、演算子が使用されています。アドバンスフィルターを使用すると、例えば今週作成されたチケットや削除されていないすべてのチケットを検索できます：

_filters=[["date_created","DP","TW"]]
_filters=[["status","NI","X,B"]]

また、複数の条件を1つのフィルターに組み合わせることもできます。例えば、先月作成された保留中のチケットをすべて検索する場合：

_filters=[["status","E","W"],["date_created","DP","LM"]]

すべてのアドバンスフィルターで以下の演算子を使用できます：

論理演算子
演算子	説明	使用例
L	Like（部分一致）	[[“tags”,“L”,“3bg4”]]
NL	Not like（部分不一致）	[[“field_player_id”,“NL”,“007”]]
E	Equals（等しい）	[[“status”,“E”,“N”]]
NE	Not equals（等しくない）	[[“field_player_id”,“NE”,“007”]]
CY	Contains any of（いずれかを含む）	[[“tags”,“CY”,“3bg4,9aue”]]
IN	Is in（含まれる）	[[“departmentid”,“IN”,“8ld2hdk5,klt0srua”]]
NI	Not in（含まれない）	[[“departmentid”,“NI”,“default,8ld2hdk5”]]
IE	Is empty（空である）	[[“company_id”,“IE”,""]]
INE	Is not empty（空でない）	[[“company_id”,“INE”,""]]

ブラウザ通話のマイク権限

電話番号の接続