アプリケーションを作成 POST
メッセージを整理・分類するための新しいアプリケーションを作成します。
エンドポイント
POST https://api.pocketalert.app/v1/applications認証
必須
リクエストに以下のヘッダーのいずれかを含めてください:
リクエスト
ヘッダー
| ヘッダー | 必須 | 説明 |
|---|---|---|
Content-Type | ✅ | application/json |
Token | ✅ | API キー |
Authorization | ✅ | Bearer <jwt-token> |
ボディパラメーター
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
name | string | ✅ | アプリケーション名 |
color | string | ❌ | アプリケーションの色(16 進数) |
リクエストの例
bash
curl -X POST "https://api.pocketalert.app/v1/applications" \
-H "Token: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"name": "Production Monitoring",
"color": "#FF0000"
}'javascript
const response = await fetch('https://api.pocketalert.app/v1/applications', {
method: 'POST',
headers: {
'Token': 'your-api-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: 'Production Monitoring',
color: '#FF0000'
})
});
const application = await response.json();
console.log(application);python
import requests
response = requests.post(
'https://api.pocketalert.app/v1/applications',
headers={
'Token': 'your-api-key',
'Content-Type': 'application/json'
},
json={'name': 'Production Monitoring', 'color': '#FF0000'}
)
print(response.json())php
$response = Http::withHeaders([
'Token' => 'your-api-key',
])->post('https://api.pocketalert.app/v1/applications', [
'name' => 'Production Monitoring',
'color' => '#FF0000',
]);
return $response->json();レスポンス
成功時のレスポンス
201 Created
アプリケーションが正常に作成されました
| フィールド | 型 | 説明 |
|---|---|---|
tid | string | アプリケーションの一意の識別子 |
name | string | アプリケーション名 |
color | string | アプリケーションの色 |
is_active | boolean | アプリケーションが有効かどうか |
created_at | string | 作成日時 |
json
{
"tid": "iemkz2tlbakj4lgns961ohx0o",
"name": "Production Monitoring",
"color": "#FF0000",
"is_active": true,
"created_at": "18.01.2026 15:29:02"
}エラーレスポンス
| ステータス | 説明 |
|---|---|
401 | 認証エラー — トークンが無効または未指定です |
400 | 不正なリクエスト — リクエストボディが無効です |