# AtoLog — AI Agent Instructions

AtoLog は企業向けのセキュアPDF共有サービスです。
このファイルを読んだAIエージェントは、以下の手順でAtoLog APIを使ってPDFをアップロードし、共有URLを取得できます。

---

## セットアップ（初回のみ）

APIを利用するには `atolog_upload.setting` ファイルが必要です。
このファイルに接続先ドメインとAPIキーが記載されています。

**取得手順：**
1. AtoLog ダッシュボード（https://atolog.quink.jp/dashboard）にログイン
2. サイドバーの「アカウント設定」を開く
3. 「APIキー」セクションで「APIキーを生成する」をクリック
4. 「⬇ atolog_upload.setting」ボタンでファイルをダウンロード
5. ダウンロードしたファイルをアップロードスクリプトと同じフォルダに置く

**ファイル形式：**

```
DOMAIN=atolog.quink.jp
API_KEY=atolog_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
```

AIエージェントが自律的にAPIを呼び出す場合は、ユーザーに `atolog_upload.setting` の内容を提示してもらい、`DOMAIN` と `API_KEY` を読み取ってください。

---

## 認証

すべてのAPIリクエストに以下のヘッダーを付与してください：

```
X-API-Key: <atolog_upload.setting の API_KEY の値>
```

`atolog_upload.setting` の `DOMAIN` の値がベースURLになります（例: `atolog.quink.jp`）。

---

## PDFをアップロードする

**エンドポイント**

```
POST https://atolog.quink.jp/api/upload
Content-Type: multipart/form-data
X-API-Key: atolog_xxxxx
```

**パラメータ**

| フィールド | 必須 | 説明 |
|-----------|------|------|
| `file` | ✅ | アップロードするPDFファイル（PDFのみ） |
| `expiresAt` | - | 公開期限（ISO 8601形式 例: 2026-12-31T23:59:00） |
| `maxViews` | - | 最大閲覧回数（整数） |
| `allowedIps` | - | アクセス許可IPアドレス（カンマ区切り） |

**レスポンス（成功時）**

```json
{
  "success": true,
  "id": "abc123xyz",
  "share_url": "https://atolog.quink.jp/?doc=abc123xyz#key=hexkey",
  "name": "document",
  "key": "hexkey",
  "created_at": "2026-01-01T00:00:00Z"
}
```

`share_url` がそのまま共有できるリンクです。このURLをメール・Slack・チャットに貼り付けて使ってください。

**エラーレスポンス**

```json
{ "error": "エラーの内容" }
```

---

## ドキュメント一覧を取得する

```
GET https://atolog.quink.jp/api/docs
X-API-Key: atolog_xxxxx
```

レスポンス：ドキュメントの配列（各オブジェクトに `share_url` を含む）

---

## 閲覧ログを取得する

```
GET https://atolog.quink.jp/api/logs
X-API-Key: atolog_xxxxx
```

レスポンス：閲覧ログの配列（email・timestamp・doc_id を含む）

---

## コード例

### curl

```bash
# atolog_upload.setting を読み込んでアップロード
source atolog_upload.setting  # または手動で設定
curl -X POST https://${DOMAIN}/api/upload \
  -H "X-API-Key: ${API_KEY}" \
  -F "file=@report.pdf"
```

### Python

```python
import requests

# atolog_upload.setting を読み込む
config = {}
with open("atolog_upload.setting") as f:
    for line in f:
        if "=" in line and not line.startswith("#"):
            k, v = line.strip().split("=", 1)
            config[k] = v

r = requests.post(
    f"https://{config['DOMAIN']}/api/upload",
    headers={"X-API-Key": config["API_KEY"]},
    files={"file": open("report.pdf", "rb")}
)
data = r.json()
print(data["share_url"])  # → 共有URL
```

---

## AIエージェントへの指示例

ユーザーから以下のような指示を受けた場合、上記のAPIを使って処理してください：

- 「このPDFをアップロードしてURLを教えて」
  → `atolog_upload.setting` から `DOMAIN` と `API_KEY` を読み取り、`/api/upload` にファイルをPOSTして `share_url` を返す

- 「アップロード済みのファイル一覧を見せて」
  → `GET /api/docs` を呼び出してリストを返す

- 「誰がいつ閲覧したか確認して」
  → `GET /api/logs` を呼び出してログを返す

- 「期限付きで共有リンクを作って（7日後に失効）」
  → `expiresAt` パラメータに7日後のISO 8601日時を指定してアップロード

---

## 注意事項

- アップロードできるのはPDFファイル（.pdf）のみです
- `share_url` のURLフラグメント（`#key=...`）に復号キーが含まれます。このキーはサーバーには送信されないため、サービス管理者でもファイルの内容を閲覧できません
- `atolog_upload.setting` の `API_KEY` は秘密情報です。第三者に漏洩しないよう管理してください
- APIキーを変更した場合は、ダッシュボードから新しい `atolog_upload.setting` を再ダウンロードしてください