Password Pusher API v2

ベータ

統合のための包括的なREST APIドキュメント Password Pusher アプリケーションに

ベータ版のお知らせ： API v2は現在ベータ版です。安定性を確保するためにあらゆる努力をしていますが、最終リリースまでに変更される可能性があります。フィードバックをお待ちしております！

リクエスト

リクエストは、機密情報を収集するためのセキュアな双方向通信を可能にします。秘密のURLでリクエストを作成し、それを誰とでも共有し、テキストまたはファイルを含む安全なレスポンスを受け取ります。

認証情報、APIキー、機密文書、または同僚、クライアント、顧客からの機密情報の収集に最適です。レスポンスは自動的に暗号化され、指定された期間後に自動削除されるため、データの露出を最小限に抑えることができます。各リクエストの監査ログで、ライフサイクルの完全な追跡が可能です。

リクエストには3つの状態がある：

open リクエストが作成され、応答を待っています。リクエストのURLを受信者と共有します。

ready 応答が提供され、検索できるようになった。元のリクエスト元はその応答にアクセスできるようになりました。

closed リクエストの有効期限が切れたか、手動でクローズされた。すべての機密データは永久に削除されました。

POST /api/v2/requests

新しいリクエストを作成する。 認証が必要。

Request Body (JSON)

{
  "request": {
    "request": "Please provide your hosting information here.",
    "close_after_duration": 8,
    "passphrase": "optional_passphrase",
    "name": "Database Access Request",
    "note": "Internal note",
    "retrieval_step": true,
    "include_requestor": false,
    "response_file_attachments": true
  }
}

Request Body with Files (multipart/form-data)

curl -X POST https://eu.pwpush.com/api/v2/requests \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "request[request]=Please provide your hosting information here." \
  -F "request[close_after_duration]=8" \
  -F "request[name]=Database Access Request" \
  -F "request[files][]=@/path/to/document.pdf" \
  -F "request[files][]=@/path/to/spreadsheet.xlsx"

Note: When attaching files, use multipart/form-data format. Multiple files can be attached using request[files][].

Parameters

Parameter	Type	Description
`request` 必要	string	共有するリクエスト・テキスト／メッセージ
`close_after_duration` オプション	integer (0-17)	Duration enum - リクエストをいつクローズするか。
`passphrase` オプション	string	受信者は、このパスフレーズを入力する必要があります。
`name` オプション	string	ダッシュボード、通知、Eメールに表示される名前
`note` オプション	string	内部メモ（作成者のみ閲覧可能）
`retrieval_step` オプション	boolean	チャットシステムやURLスキャナがビューを食いつぶすのを避けるのに役立つ
`include_requestor` オプション	boolean	リクエストにリクエスト者の情報を含める
`response_file_attachments` オプション	boolean	回答へのファイル添付を許可する
`files` オプション	array	アップロードしてリクエストに添付するファイル
`notify_emails_to` オプション	string	リクエストが作成されたときに通知されるメールアドレス (カンマ区切り)
`notify_emails_to_locale` オプション	string	Eメール通知を送信するロケール（言語
`account_id` オプション	integer	リクエストを関連付けるアカウントID

期間 `close_after_duration`

0: 15分

1: 30分

2: 45分

3: 1時間

4: 6時間

5: 12時間

6: 1日

7: 2日

8: 3日

9: 4日

10: 5日

11: 6日

12: 1週間

13: 2週間

14: 3週間

15: 1ヶ月

16: 2ヶ月

17: 3ヶ月

リクエスト例

curl -X POST https://eu.pwpush.com/api/v2/requests \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "request": {
      "request": "Please provide your hosting information here.",
      "close_after_duration": 8,
      "passphrase": "optional_passphrase",
      "name": "Database Access Request"
    }
  }'

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://eu.pwpush.com/api/v2/requests')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Post.new(uri.path)
request['Authorization'] = 'Bearer YOUR_API_TOKEN'
request['Content-Type'] = 'application/json'
request.body = {
  request: {
    request: 'Please provide your hosting information here.',
    close_after_duration: 8,
    passphrase: 'optional_passphrase',
    name: 'Database Access Request'
  }
}.to_json

response = http.request(request)
puts response.body

import requests
import json

url = 'https://eu.pwpush.com/api/v2/requests'
headers = {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
}
data = {
    'request': {
        'request': 'Please provide your hosting information here.',
        'close_after_duration': 8,
        'passphrase': 'optional_passphrase',
        'name': 'Database Access Request'
    }
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

$headers = @{
    'Authorization' = 'Bearer YOUR_API_TOKEN'
    'Content-Type' = 'application/json'
}

$body = @{
    request = @{
        request = 'Please provide your hosting information here.'
        close_after_duration = 8
        passphrase = 'optional_passphrase'
        name = 'Database Access Request'
    }
} | ConvertTo-Json -Depth 10

$response = Invoke-RestMethod -Uri 'https://eu.pwpush.com/api/v2/requests' `
    -Method Post `
    -Headers $headers `
    -Body $body

$response | ConvertTo-Json

GET /api/v2/requests/:url_token

開いている、あるいは準備ができたリクエストの内容を取得します。特定のビュー数の後に閉じるように設定されている場合は、リクエストを閉じるかもしれません。

リクエスト例

curl -X GET https://eu.pwpush.com/api/v2/requests/orpw2wkg00vpn0a

パスフレーズ付きリクエスト例

curl -X GET "https://eu.pwpush.com/api/v2/requests/orpw2wkg00vpn0a?passphrase=your_passphrase"

応答例（オープンリクエスト）

{
  "close_after_duration": 8,
  "url_token": "orpw2wkg00vpn0a",
  "retrieval_step": true,
  "passphrase": "optional_passphrase",
  "created_at": "2023-10-27T10:00:00.000Z",
  "updated_at": "2023-10-27T10:00:00.000Z",
  "state": "open",
  "include_requestor": false,
  "response_file_attachments": true,
  "close_after_at": "2023-11-04T10:00:00.000Z",
  "days_remaining": 8,
  "json_url": "https://eu.pwpush.com/r/orpw2wkg00vpn0a.json",
  "html_url": "https://eu.pwpush.com/r/orpw2wkg00vpn0a",
  "request": "Please provide your hosting information here.",
  "response": null,
  "files": []
}

応答例（レディリクエスト）

{
  "close_after_duration": 8,
  "url_token": "orpw2wkg00vpn0a",
  "retrieval_step": true,
  "passphrase": "optional_passphrase",
  "created_at": "2023-10-27T10:00:00.000Z",
  "updated_at": "2023-10-27T10:00:00.000Z",
  "state": "ready",
  "include_requestor": false,
  "response_file_attachments": true,
  "close_after_at": "2023-11-04T10:00:00.000Z",
  "days_remaining": 8,
  "json_url": "https://eu.pwpush.com/r/orpw2wkg00vpn0a.json",
  "html_url": "https://eu.pwpush.com/r/orpw2wkg00vpn0a",
  "request": null,
  "response": "The API key is: sk_live_1234567890",
  "files": []
}

注：リクエストにパスフレーズがある場合は、それをクエリパラメータとして含めます： ?passphrase=your_passphrase. リクエストの取得はビューとしてカウントされ、ビューの制限に達した場合、リクエストを閉じるかもしれません。

PATCH /api/v2/requests/:url_token/respond

オープンリクエストに応答し、状態を「ready」に変更する。

Request Body (JSON)

{
  "request": {
    "response": "The API key is: sk_live_1234567890"
  }
}

Request Body with Files (multipart/form-data)

curl -X PATCH https://eu.pwpush.com/api/v2/requests/orpw2wkg00vpn0a/respond \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "request[response]=The API key is: sk_live_1234567890" \
  -F "request[files][]=@/path/to/response_doc.pdf"

Note: When attaching files, use multipart/form-data format. Multiple files can be attached using request[files][].

パラメータ

パラメータ	タイプ	説明
`response` 必要	string	リクエストに対するレスポンスのテキスト／メッセージ
`files` オプション	array	回答に添付するファイル（複数可 `response_file_attachments: true` リクエスト)

注： open」ステートにあるリクエストだけが応答を受け取ることができる。応答が送信されると、リクエストは "ready "ステートに移行し、追加の応答を受け取ることができなくなる。

GET /api/v2/requests/:url_token/preview

リクエストの内容を取得せずに、完全修飾された秘密の URL を返します。

リクエスト例

curl -X GET https://eu.pwpush.com/api/v2/requests/orpw2wkg00vpn0a/preview

回答例

{
  "url": "https://eu.pwpush.com/r/orpw2wkg00vpn0a"
}

GET /api/v2/requests/:url_token/audit

リクエストの監査ログを返します。認証と所有者が必要です。

クエリーパラメーター

page (オプション): ページネーション用のページ番号。

デフォルト： 1 (最初のページ)
範囲： 1 への 200
1ページあたり最大50件の監査ログエントリを返します。
例 ?page=2 2ページ目を取得する

リクエスト例

curl -X GET https://eu.pwpush.com/api/v2/requests/orpw2wkg00vpn0a/audit \
  -H "Authorization: Bearer YOUR_API_TOKEN"

回答例

{
  "logs": [
    {
      "ip": "192.168.1.100",
      "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
      "referrer": null,
      "kind": "creation",
      "created_at": "2023-10-27T10:00:00.000Z",
      "updated_at": "2023-10-27T10:00:00.000Z"
    },
    {
      "ip": "192.168.1.101",
      "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36",
      "referrer": "https://example.com",
      "kind": "view",
      "created_at": "2023-10-27T10:05:00.000Z",
      "updated_at": "2023-10-27T10:05:00.000Z"
    },
    {
      "ip": "192.168.1.102",
      "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 14_0 like Mac OS X) AppleWebKit/605.1.15",
      "referrer": null,
      "kind": "response",
      "created_at": "2023-10-27T10:10:00.000Z",
      "updated_at": "2023-10-27T10:10:00.000Z"
    }
  ]
}

注：について kind フィールドは、ログに記録されるアクションのタイプを示す。一般的な値は以下の通り： creation, view, response, close, failed_passphrase, と failed_view.

DELETE /api/v2/requests/:url_token

リクエストを直ちに閉じ、それに関連付けられたすべての機密データを永久に削除する。この動作は不可逆であり、元に戻すことはできません。認証と所有権が必要です。

リクエスト例

curl -X DELETE https://eu.pwpush.com/api/v2/requests/orpw2wkg00vpn0a \
  -H "Authorization: Bearer YOUR_API_TOKEN"

回答例

{
  "close_after_duration": null,
  "url_token": "orpw2wkg00vpn0a",
  "retrieval_step": false,
  "passphrase": null,
  "created_at": "2023-10-27T10:00:00.000Z",
  "updated_at": "2023-10-27T10:15:00.000Z",
  "state": "closed",
  "include_requestor": false,
  "response_file_attachments": false,
  "close_after_at": null,
  "days_remaining": null,
  "json_url": "https://eu.pwpush.com/r/orpw2wkg00vpn0a.json",
  "html_url": "https://eu.pwpush.com/r/orpw2wkg00vpn0a",
  "account_id": 1,
  "note": null,
  "name": null,
  "request": null,
  "response": null,
  "files": []
}

GET /api/v2/requests/active

アクティブな (open あるいは ready) リクエストの一覧をページ分割して返します。認証が必要です。

GET /api/v2/requests/open

開いているリクエストの一覧をページ分割して返します。認証が必要です。

GET /api/v2/requests/ready

準備できたリクエストの一覧をページ分割して返します。認証が必要です。

GET /api/v2/requests/closed

クローズされたリクエストの一覧をページ分割して返します。認証が必要です。

クエリーパラメーター

page (オプション): ページネーション用のページ番号。

デフォルト： 1 (最初のページ)
範囲： 1 への 200
1ページあたり最大50リクエストまで返せる
例 ?page=2 2ページ目を取得する

要請国

open

リクエストオープン

リクエストは作成され、応答を待っている。リクエストテキストは表示されていますが、まだ応答はありません。

ready

応答準備完了

リクエストは応答され、応答ペイロードを含むようになった。リクエストテキストは見えなくなりましたが、レスポンスは取得可能です。

closed

閉鎖

リクエストは処理され、すべての機密データ(リクエストと応答の両方)は永久に削除された。この状態は不可逆である。

リクエスト例（アクティブ）

curl -X GET https://eu.pwpush.com/api/v2/requests/active \
  -H "Authorization: Bearer YOUR_API_TOKEN"

リクエスト例（オープン）

curl -X GET https://eu.pwpush.com/api/v2/requests/open \
  -H "Authorization: Bearer YOUR_API_TOKEN"

リクエスト例（レディ）

curl -X GET https://eu.pwpush.com/api/v2/requests/ready \
  -H "Authorization: Bearer YOUR_API_TOKEN"

リクエスト例（クローズド）

curl -X GET https://eu.pwpush.com/api/v2/requests/closed \
  -H "Authorization: Bearer YOUR_API_TOKEN"

回答例

[
  {
    "close_after_duration": 7,
    "url_token": "abc123xyz789",
    "retrieval_step": false,
    "passphrase": null,
    "created_at": "2023-10-27T10:00:00.000Z",
    "updated_at": "2023-10-27T10:00:00.000Z",
    "state": "open",
    "include_requestor": false,
    "response_file_attachments": false,
    "close_after_at": "2023-11-03T10:00:00.000Z",
    "days_remaining": 7,
    "json_url": "https://eu.pwpush.com/r/abc123xyz789.json",
    "html_url": "https://eu.pwpush.com/r/abc123xyz789",
    "account_id": 1,
    "note": null,
    "name": null
  },
  {
    "close_after_duration": 7,
    "url_token": "def456uvw012",
    "retrieval_step": false,
    "passphrase": null,
    "created_at": "2023-10-26T15:30:00.000Z",
    "updated_at": "2023-10-27T09:00:00.000Z",
    "state": "ready",
    "include_requestor": false,
    "response_file_attachments": false,
    "close_after_at": "2023-11-02T15:30:00.000Z",
    "days_remaining": 6,
    "json_url": "https://eu.pwpush.com/r/def456uvw012.json",
    "html_url": "https://eu.pwpush.com/r/def456uvw012",
    "account_id": 1,
    "note": null,
    "name": null
  }
]

注：について /active エンドポイントは open と ready 州使用 /open また /ready エンドポイントを使用して、特定の状態でフィルタリングします。

最終更新日 July 12, 2026

Password Pusher API v2

リクエスト

リクエストには3つの状態がある：

リクエストの作成

Request Body (JSON)

Request Body with Files (multipart/form-data)

Parameters

期間 `close_after_duration`

リクエスト例

リクエストの取得

リクエスト例

パスフレーズ付きリクエスト例

応答例（オープンリクエスト）

応答例（レディリクエスト）

リクエストに応える

Request Body (JSON)

Request Body with Files (multipart/form-data)

パラメータ

リクエストをプレビューする

リクエスト例

回答例

リクエスト監査ログの取得

リクエスト例

回答例

リクエストを閉じる

リクエスト例

回答例

コレクションのリクエスト

要請国

リクエスト例（アクティブ）

リクエスト例（オープン）

リクエスト例（レディ）

リクエスト例（クローズド）

回答例

Password Pusher API v2

リクエスト

リクエストには3つの状態がある：

リクエストの作成

Request Body (JSON)

Request Body with Files (multipart/form-data)

Parameters

期間 close_after_duration

リクエスト例

リクエストの取得

リクエスト例

パスフレーズ付きリクエスト例

応答例（オープンリクエスト）

応答例（レディリクエスト）

リクエストに応える

Request Body (JSON)

Request Body with Files (multipart/form-data)

パラメータ

リクエストをプレビューする

リクエスト例

回答例

リクエスト監査ログの取得

リクエスト例

回答例

リクエストを閉じる

リクエスト例

回答例

コレクションのリクエスト

要請国

リクエスト例（アクティブ）

リクエスト例（オープン）

リクエスト例（レディ）

リクエスト例（クローズド）

回答例

期間 `close_after_duration`