# TimeZoneAPI

## Timezone API リファレンス

### サービス名

**Timezone API**

### 利用用途

`Timezone API`は、指定されたタイムゾーンにおける現在の日時を取得するためのAPIです。このAPIを利用することで、異なる都市や地域の現在時刻を取得し、アプリケーションやウェブサイトでの時間表示に役立てることができます。

***

### API エンドポイント

```
https://events-front.mixeder.net/v1/timezone
```

***

### パラメータ

| パラメータ      | 必須 | 説明                               |
| ---------- | -- | -------------------------------- |
| `key`      | 必須 | 利用者のAPIキー                        |
| `timezone` | 必須 | 取得したい都市のタイムゾーン名（例: `Asia/Tokyo`） |

***

### 利用方法

1. 有効なAPIキーを用意します。
2. 取得したいタイムゾーンを`timezone`パラメータに指定します。
3. APIリクエストを送信すると、指定されたタイムゾーンの現在時刻が返されます。

***

### サンプルコード

#### cURL

```bash
curl "https://events-front.mixeder.net/v1/timezone?key=YOUR_API_KEY&timezone=Asia/Tokyo"
```

#### Node.js

```javascript
const https = require('https');

const url = 'https://events-front.mixeder.net/v1/timezone?key=YOUR_API_KEY&timezone=Asia/Tokyo';

https.get(url, (res) => {
    let data = '';
    res.on('data', (chunk) => {
        data += chunk;
    });
    res.on('end', () => {
        console.log(data);
    });
}).on('error', (err) => {
    console.error('Error: ' + err.message);
});
```

#### Python

```python
import requests

url = "https://events-front.mixeder.net/v1/timezone"
params = {
    "key": "YOUR_API_KEY",
    "timezone": "Asia/Tokyo"
}

response = requests.get(url, params=params)
if response.status_code == 200:
    print(response.json())
else:
    print(f"Error: {response.status_code}")
```

***

### エラーメッセージ

* **API Key not provided.**: APIキーが指定されていません。
* **Timezone not provided.**: タイムゾーンが指定されていません。
* **API key is wrong**: APIキーが無効です。

***

### 注意事項

* 有効なAPIキーが必要です。指定がない場合や無効な場合はリクエストは拒否されます。
* `timezone`パラメータには、正確なタイムゾーン名（例: `Asia/Tokyo`, `America/New_York`）を指定してください。