APIドキュメント

JWT認証でIP地理位置検索APIにアクセス

認証

APIドメイン: api.ip-query.com

認証方法: JWT JWTトークン

APIキー割り当て: GitHub OAuth2ログインを使用して取得

トークンの取り消し

APIトークンを取り消して、アクセスを無効にします。

curl -X DELETE https://api.ip-query.com/api/revoke-token \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "X-Revoke-Token: TOKEN_TO_REVOKE"

APIエンドポイント

GET /api/lookup/:ip

指定されたIPアドレスの地理位置情報を取得

パラメータ:
  • ip (必須) - クエリするIPアドレス（IPv4およびIPv6をサポート）
  • Authorization (必須) - GitHub OAuth2で取得したJWTトークン
使用例:
curl -X GET https://api.ip-query.com/api/lookup/8.8.8.8 \ -H "Authorization: Bearer YOUR_JWT_TOKEN"
レスポンス例:
{ "ip": "8.8.8.8", "country": "United States", "country_code": "US", "region": "California", "city": "Mountain View", "isp": "Google LLC", "latitude": 37.4056, "longitude": -122.0775, "timezone": "America/Los_Angeles", "zip": "94043" }

GET /api/status

APIサービスステータスとヘルスチェックを取得

パラメータ:
  • Authorization (必須) - GitHub OAuth2で取得したJWTトークン
使用例:
curl -X GET https://api.ip-query.com/api/status \ -H "Authorization: Bearer YOUR_JWT_TOKEN"

GET /api/myip

自分のIPアドレスの地理位置情報を取得

パラメータ:
  • Authorization (必須) - GitHub OAuth2で取得したJWTトークン
使用例:
curl -X GET https://api.ip-query.com/api/myip \ -H "Authorization: Bearer YOUR_JWT_TOKEN"

レート制限