API ドキュメント

Quick Drop は curl だけで使えます。下の欄にキーワードを入れると、このページのすべての例に反映されます。例をコピーしてそのまま実行できます。

• 基本
• 1. フォルダを作る
• 2. ファイルを送る
• 3. テキストを送る
• 4. 中身を見る
• 5. まとめてダウンロード
• 6. 1 つだけダウンロード
• 7. 削除する
• Windows で使う
• キーワードの決まり
• 制限
• エラー
• 削除と記録

基本

• URL: https://qd.loject.jp
• キーワードは X-Keyword ヘッダーで渡します。URL には入れません (記号で URL が壊れるのと、履歴やログに残るのを避けるため)。
• 流れは「フォルダを作る → ファイルやテキストを送る → 相手がダウンロード → 削除」です。フォルダは作った時点から保存期間を数え、過ぎるとすべて削除されます。
• 応答は JSON です (ダウンロードを除く)。失敗したときは {"error":{"code":"...","message":"..."}} が返ります。

1. フォルダを作る

保存期間は既定で 10 分です。

curl -X POST -H 'X-Keyword: ここにキーワード' https://qd.loject.jp/api/folder

保存期間を変えるときは X-Expires に分で指定します (1〜1440 = 最長 1 日)。例は 30 分。

curl -X POST -H 'X-Keyword: ここにキーワード' -H 'X-Expires: 30' https://qd.loject.jp/api/folder

作るのと同時にテキストを入れることもできます。

curl -X POST -H 'X-Keyword: ここにキーワード' --data-binary 'ここに共有したいテキスト' https://qd.loject.jp/api/folder

同じキーワードのフォルダが使用中なら 409 keyword_in_use になります。別のキーワードにしてください。

2. ファイルを送る

先に「1. フォルダを作る」を実行してから送ります。-T でファイルを指定し、URL を / で終えると、curl がファイル名を付け足して送ります。

curl -H 'X-Keyword: ここにキーワード' -T report.pdf https://qd.loject.jp/api/files/

複数のファイルは { } の中にカンマ区切りで並べます (1 つずつ順に送られます)。

curl -H 'X-Keyword: ここにキーワード' -T '{report.pdf,photo.jpg,data.zip}' https://qd.loject.jp/api/files/

今いるディレクトリのファイルをすべて送る (macOS / Linux)。

for f in *; do [ -f "$f" ] && curl -H 'X-Keyword: ここにキーワード' -T "$f" https://qd.loject.jp/api/files/; done

名前を変えて送るときは、URL の最後に新しい名前を書きます (英数字の名前をおすすめします)。

curl -H 'X-Keyword: ここにキーワード' -T report.pdf https://qd.loject.jp/api/files/report-final.pdf

3. テキストを送る

curl -H 'X-Keyword: ここにキーワード' --data-binary 'ここに共有したいテキスト' https://qd.loject.jp/api/text

ファイルの中身をテキストとして送る。

curl -H 'X-Keyword: ここにキーワード' --data-binary @memo.txt https://qd.loject.jp/api/text

クリップボードの内容を送る (macOS)。

pbpaste | curl -H 'X-Keyword: ここにキーワード' --data-binary @- https://qd.loject.jp/api/text

-d ではなく --data-binary を使ってください。-d は改行を消してしまいます。

4. 中身を見る

curl -H 'X-Keyword: ここにキーワード' https://qd.loject.jp/api/folder

応答の例 (テキストは本文も入っています)。

{
  "createdAt": "2026-09-14T06:00:00.000Z",
  "expiresAt": "2026-09-14T06:10:00.000Z",
  "remainingSeconds": 598,
  "totalSize": 48213,
  "items": [
    { "id": "4f1c...", "type": "file", "name": "report.pdf", "size": 48177,
      "createdAt": "2026-09-14T06:00:05.000Z", "path": "/api/files/4f1c..." },
    { "id": "9ab2...", "type": "text", "name": "text.txt", "size": 36,
      "createdAt": "2026-09-14T06:00:00.000Z", "path": "/api/files/9ab2...",
      "text": "ここに共有したいテキスト" }
  ]
}

5. まとめてダウンロード

フォルダの中身すべてを 1 本の tar で受け取り、そのまま展開します。テキストは text.txt として入ります。

curl -H 'X-Keyword: ここにキーワード' https://qd.loject.jp/api/archive | tar -xvf -

展開先のディレクトリを決める。

mkdir received && curl -H 'X-Keyword: ここにキーワード' https://qd.loject.jp/api/archive | tar -xvf - -C received

展開せずにファイルとして保存する。

curl -H 'X-Keyword: ここにキーワード' -o quickdrop.tar https://qd.loject.jp/api/archive

同じ名前のファイルがあるときは、2 つ目以降が 名前 (2).拡張子 になります。ZIP ではなく tar なのは、サーバーの負荷を抑えるためです (tar は macOS・Linux・Windows 10 以降に標準で入っています)。

6. 1 つだけダウンロード

<id> は「4. 中身を見る」の items[].id です。

curl -H 'X-Keyword: ここにキーワード' -o report.pdf https://qd.loject.jp/api/files/<id>

7. 削除する

保存期間を待たずに、フォルダを中身ごとすぐに削除します。受け取りが終わったら実行してください。キーワードを知っていれば誰でも削除できます。

curl -X DELETE -H 'X-Keyword: ここにキーワード' https://qd.loject.jp/api/folder

Windows で使う

Windows 10 / 11 には curl と tar が標準で入っています。PowerShell では curl が別のコマンドを指すことがあるため、curl.exe と書いてください。上の例の '...' はそのまま使えます。

curl.exe -H 'X-Keyword: ここにキーワード' -T report.pdf https://qd.loject.jp/api/files/

curl.exe -H 'X-Keyword: ここにキーワード' -o quickdrop.tar https://qd.loject.jp/api/archive; tar -xvf quickdrop.tar

コマンドプロンプト (cmd.exe) では ' の代わりに " で囲んでください。

キーワードの決まり

• 8〜64 文字。英字・数字・記号をそれぞれ 1 文字以上含めてください。
• 使える記号: ! # $ % & ( ) * + , - . / : ; < = > ? @ [ ] ^ _ { | } ~
• スペース・'・"・`・\・日本語は使えません。
• 大文字と小文字は区別しません。全角で入力した英数字・記号は半角として扱います。
• 他人に推測されにくいものにしてください。迷ったら「自動で作る」を使ってください。

制限

エラー

スクリプトで使うときは --fail-with-body を付けると、失敗したときに curl が終了コード 22 で止まります。

削除と記録

• 保存期間が過ぎたフォルダは、その時点で開けなくなり、ファイルもテキストも 1〜2 分以内にサーバーから削除されます。「削除する」を実行した場合はその場で削除されます。
• キーワードそのものは保存しません。照合には、サーバーだけが持つ鍵で変換した値を使います。
• 不正利用や情報漏洩の調査のため、次の記録は削除後も保管します: 日時・操作の種類と結果・IP アドレス・国・ブラウザや curl の種類 (User-Agent)・ファイル名・サイズ。
• ファイルの中身とテキストの中身は記録しません。