最小限のリクエスト例（必須パラメータのみ）

curl -X POST https://api.miryo.ai/api/quotes/generate \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key_here" \
  -d '{
    "issuer": {
      "company": "miryo.AI株式会社"
    },
    "customer": {
      "company": "株式会社サンプル"
    },
    "quote": {
      "subject": "システム開発見積",
      "items": [
        {
          "name": "開発作業",
          "quantity": 10,
          "unitPrice": 50000,
          "amount": 500000
        }
      ]
    }
  }' \
  --output quote.pdf

完全なリクエスト例（全オプション指定）

curl -X POST https://api.miryo.ai/api/quotes/generate \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key_here" \
  -d '{
    "issuer": {
      "company": "miryo.AI株式会社",
      "email": "info@miryo.ai",
      "phone": "050-1725-6435",
      "address": "東京都港区...",
      "contactPerson": "山田太郎"
    },
    "customer": {
      "company": "株式会社サンプル",
      "name": "田中花子",
      "email": "tanaka@example.com",
      "phone": "03-9876-5432",
      "department": "営業部",
      "position": "部長",
      "nameKana": "タナカ ハナコ",
      "zipCode": "150-0001",
      "address": "東京都渋谷区..."
    },
    "quote": {
      "quoteNumber": "QT-2025-001",
      "issueDate": "2025-01-15T09:00:00.000Z",
      "validUntil": "2025-02-14T23:59:59.999Z",
      "subject": "システム開発業務委託",
      "items": [
        {
          "name": "要件定義",
          "majorCategory": "上流工程",
          "description": "システム要件の洗い出しと仕様策定",
          "quantity": 5.0,
          "unitPrice": 80000,
          "amount": 400000
        },
        {
          "name": "基本設計",
          "majorCategory": "上流工程",
          "quantity": 10.0,
          "unitPrice": 70000,
          "amount": 700000
        }
      ],
      "taxRate": 0.1,
      "paymentTerms": "納品後30日以内に指定口座へお振込みください",
      "notes": "見積有効期限: 発行日より30日間\n※金額は税抜価格です",
      "showItemDescription": true,
      "fontSize": {
        "customerCompany": 20,
        "customerName": 16
      },
      "tableColumns": {
        "showNo": true,
        "showMajorCategory": true
      }
    }
  }' \
  --output quote.pdf

リクエストパラメータ

レスポンス

PDF Binary Data (application/pdf)

Response Headers:
Content-Type: application/pdf
Content-Disposition: attachment; filename="quote-QT-2025-001.pdf"
X-Quote-Number: QT-2025-001

注: 見積書番号がリクエストで指定されていない場合、X-Quote-Numberヘッダーは含まれません。

エラーレスポンス

{
  "error": "Invalid request data",
  "details": [
    {
      "code": "invalid_type",
      "expected": "string",
      "received": "undefined",
      "path": ["customer", "email"],
      "message": "Required"
    }
  ]
}

{
  "error": "API key is required"
}

サンプルコード

const axios = require('axios');
const fs = require('fs');

async function generateQuote() {
  const response = await axios.post(
    'https://api.miryo.ai/api/quotes/generate',
    {
      issuer: { company: 'miryo.AI株式会社' },
      customer: {
        company: '株式会社サンプル'
      },
      quote: {
        subject: 'システム開発見積',
        items: [{
          name: '開発作業',
          quantity: 10,
          unitPrice: 50000,
          amount: 500000  // quantity × unitPrice
        }]
      }
    },
    {
      headers: { 'x-api-key': 'your_api_key_here' },
      responseType: 'arraybuffer'
    }
  );

  fs.writeFileSync('quote.pdf', response.data);
  if (response.headers['x-quote-number']) {
    console.log('Quote Number:', response.headers['x-quote-number']);
  }
}

import requests

def generate_quote():
    response = requests.post(
        'https://api.miryo.ai/api/quotes/generate',
        headers={'x-api-key': 'your_api_key_here'},
        json={
            'issuer': {'company': 'miryo.AI株式会社'},
            'customer': {
                'company': '株式会社サンプル'
            },
            'quote': {
                'subject': 'システム開発見積',
                'items': [{
                    'name': '開発作業',
                    'quantity': 10,
                    'unitPrice': 50000,
                    'amount': 500000  # quantity × unitPrice
                }]
            }
        }
    )

    with open('quote.pdf', 'wb') as f:
        f.write(response.content)

    quote_number = response.headers.get('X-Quote-Number')
    if quote_number:
        print('Quote Number:', quote_number)

注意事項

• 【重要】amount = quantity × unitPrice で計算してください
• 【日付フォーマット】ISO 8601形式で指定（例: "2025-01-15T09:00:00.000Z"）
• 【税率】デフォルト0.1 (10%)。0.0～1.0の範囲で指定可能
• 【自動改ページ】コンテンツに応じて自動的に改ページされます
• 【データ保存】このAPIは見積書を保存しません。PDF生成のみを行います