すぐFAX SuguFAX – Pay per fax (no account)

送信先とページ数からFAXの料金（日本円・税込）を確認します。送信先が対応しているか（携帯電話番号・0990・0570などは不可）もわかります。何も送信されません。

{
  "type": "object",
  "properties": {
    "fax_number": {
      "type": "string",
      "description": "送信先のFAX番号。日本の形式（03-1234-5678）または国際形式（+81312345678）"
    },
    "pages": {
      "type": "integer",
      "description": "ページ数（省略時1）",
      "default": 1,
      "minimum": 1,
      "maximum": 100
    },
    "promo_code": {
      "type": "string",
      "description": "任意：クーポンコード（割引後の料金を確認）"
    }
  },
  "required": [
    "fax_number"
  ]
}

FAXの送信を受け付け、Stripeのお支払いURL（checkout_url、日本円）を返します。お支払いが完了すると自動で送信されます。書類（いずれか1つ）："upload_id"（create_upload_link で作成、ユーザーの端末にあるファイル用）、"file"（ChatGPTで添付されたファイル、自動入力）、"document_url"（公開PDFの直接HTTPSリンク）、"document_base64"（700KBまでの小さなファイルのみ）。PDF・JPG・PNG、最大10MB・100ページ。scheduled_at を指定すると、その日時（日本時間）に送信します。

{
  "type": "object",
  "properties": {
    "fax_number": {
      "type": "string",
      "description": "送信先のFAX番号（例：03-1234-5678 または +81312345678）"
    },
    "upload_id": {
      "type": "string",
      "description": "create_upload_link が返した upload_id（ユーザーがアップロードした後）。1回のみ使用可能。"
    },
    "file": {
      "type": "object",
      "description": "ChatGPT：チャットに添付されたFAX書類（PDF・JPG・PNG）。ChatGPTが自動で入力します。",
      "properties": {
        "download_url": {
          "type": "string"
        },
        "file_id": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        }
      },
      "required": [
        "download_url",
        "file_id"
      ],
      "additionalProperties": false
    },
    "document_url": {
      "type": "string",
      "description": "公開されているPDFの直接HTTPSリンク（ログインやプレビューのページは不可）"
    },
    "document_base64": {
      "type": "string",
      "description": "小さなファイル（700KBまで）のみ：PDF・JPG・PNGのbase64またはdata: URI。通常は create_upload_link をお使いください。"
    },
    "document_name": {
      "type": "string",
      "description": "任意：書類のファイル名（送信完了レポートに表示）"
    },
    "email": {
      "type": "string",
      "description": "任意：確認メールと送信完了レポートの送信先（省略時はお支払い画面で入力）"
    },
    "scheduled_at": {
      "type": "string",
      "description": "任意：送信日時（日本時間）。例：2026-10-10T09:00（オフセットなし＝日本時間）。15分後〜30日後まで。省略すると今すぐ送信。"
    },
    "promo_code": {
      "type": "string",
      "description": "任意：すぐFAXのクーポンコード（例：SUGU15-AB2CD3）。ユーザーがクーポンを持っている場合のみ。割引後の金額で checkout_url が作成されます。"
    }
  },
  "required": [
    "fax_number"
  ]
}

send_fax の結果の token を使って、FAXの送信状況（お支払い待ち・予約中・送信中・完了など）を確認します。完了していれば送信完了レポートのURLも返します。

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "description": "send_fax が返した token（32文字）"
    }
  },
  "required": [
    "token"
  ]
}

FAX書類（PDF・JPG・PNG、最大10MB）をアップロードするための、安全なワンタイムURL（30分有効）を作成します。スマートフォンやパソコンからアップロードでき、カメラ撮影にも対応しています。ユーザーが upload_url でアップロードした後、upload_id を send_fax に渡します。リンクの作成では何も送信されず、料金もかかりません。

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}