countries-api は何をしますか?
無料のcountries.dev API用のエージェントスキル:国、都市、郵便番号、IPジオロケーション、距離。APIキー不要。
概要
このスキルは、countries.dev が提供する無料のRESTful APIにアクセスするためのエージェントスキルです。国、都市、郵便番号、IPアドレスのジオロケーション、および距離計算に関する情報を取得できます。認証は必要ありません。
エンドポイント
| メソッド | エンドポイント | 説明 |
|---|---|---|
| GET | /api/countries | すべての国をリストアップ |
| GET | /api/countries/:code | 特定の国の詳細を取得 |
| GET | /api/cities/:countryCode | 指定された国の都市をリストアップ |
| GET | /api/postal-codes/:countryCode/:postalCode | 郵便番号の情報を取得 |
| GET | /api/ip-geolocation/:ip | IPアドレスのジオロケーションを取得 |
| GET | /api/distance/:from/:to | 2地点間の距離を計算(例:緯度,経度) |
使用例
# 国の詳細を取得
curl https://countries.dev/api/countries/JP
# 日本の都市をリストアップ
curl https://countries.dev/api/cities/JP
# 郵便番号の情報を取得
curl https://countries.dev/api/postal-codes/US/90210
# IPアドレスのジオロケーションを取得
curl https://countries.dev/api/ip-geolocation/8.8.8.8
# 距離を計算
curl https://countries.dev/api/distance/48.8566,2.3522/40.7128,-74.0060
注意事項
- すべてのエンドポイントはパブリックであり、APIキーは必要ありません。
- レート制限が適用される場合があります。使用前にcountries.devのドキュメントを確認してください。
- レスポンスはJSON形式で返されます。