ジオターゲティング

ジオターゲティングはリクエストごとにユーザー名にフラグを追加することで設定します。ダッシュボードの変更も、別のエンドポイントも不要で、すべてのリクエストは同じゲートウェイを通過します。

構文

フラグはダッシュで区切ってユーザー名に追加します。

customer-USERNAME-country-<code>-region-<name>-city-<name>-asn-<number>

値はすべて小文字です。地域名と都市名はスペースの代わりにアンダースコアを使用します。国コードはISO 3166-1 alpha-2に準拠します。

フラグ	値	例
`country`	ISO国コード	`country-us`, `country-gb`, `country-de`
`region`	小文字の地域/州スラッグ	`region-california`, `region-new_south_wales`
`city`	小文字の都市スラッグ	`city-new_york`, `city-los_angeles`
`asn`	ASN番号	`asn-7922` (Comcast), `asn-701` (Verizon)
`strict`	`true`	`strict-true` (フォールバックの動作を参照)

フラグは任意の順序で組み合わせられます。

customer-USERNAME-country-us-region-california-city-los_angeles
customer-USERNAME-country-gb-asn-2856
customer-USERNAME-city-berlin

curl -x customer-USERNAME-country-de-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443 \
  https://ipinfo.io/json

curl -x customer-USERNAME-country-us-region-california-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443 \
  https://ipinfo.io/json

curl -x customer-USERNAME-country-us-city-new_york-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443 \
  https://ipinfo.io/json

curl -x customer-USERNAME-country-us-asn-7922-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443 \
  https://ipinfo.io/json

デフォルトでは、リクエスト時に完全なフィルターに一致するIPが存在しない場合(たとえば、あまり知られていない都市でプールが一時的に空になっている場合)、ゲートウェイはより広いプールにフォールバックし、リクエストが完了するようにします。

strict-true を追加するとフォールバックを無効にし、代わりに HTTP 502 を受け取ります。リクエストの成功よりも正確なジオマッチが重要な場合は、厳密なマッチングを使用してください。

curl -x customer-USERNAME-country-us-city-new_york-strict-true-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443 \
  https://ipinfo.io/json

すべてのフラグを省略すると、グローバル全体のプールから取得します。

USERNAME

すべてのリクエストは引き続き異なるIPにローテーションしますが、地理的な制約はありません。