Password Pusher API leagan 2

BÉITE

Doiciméadacht chuimsitheach REST API le haghaidh comhtháthú Password Pusher isteach i do chuid feidhmchlár

Fógra Béite: Tá API v2 i mbéite faoi láthair. Cé gur dhéanaimid gach iarracht chun cobhsaíocht a chinntiú, d'fhéadfadh athruithe bristeacha a bheith ann roimh an scaoileadh deiridh. Cuirimid fáilte roimh d'aiseolas!

Brúigh

Cumasaíonn brúnna tarchur slán, aontreo sonraí íogaire chuig faighteoirí. Cruthaigh brú le URL rúnda ina bhfuil téacs, comhaid, cóid QR, nó URLanna, agus ansin roinn é le duine ar bith—gan sonraí íogaire a nochtadh i ríomhphost, i gcomhrá ná i logaí.

Foirfe le haghaidh ionduchtú fostaithe, dintiúir chuntais a sheoladh, doiciméid rúnda a tharchur, nó aon fhaisnéis íogair a roinnt. Téann brúnna in éag go huathoibríoch tar éis tréimhse shonraithe nó líon áirithe radharcanna, agus tá rianú iomlán saolré ar fáil i logaí iniúchta gach brú.

POST /api/v2/pushes

Cruthaíonn sé brú nua leis an ualach a cuireadh ar fáil.

Corp Iarratais (JSON)

{
  "push": {
    "payload": "secret_password_123",
    "expire_after_duration": 6,
    "expire_after_views": 5,
    "passphrase": "optional_passphrase",
    "name": "Database Credentials",
    "note": "Internal note",
    "deletable_by_viewer": true,
    "retrieval_step": true,
    "kind": "text"
  },
  "workspace_id": "acct_oxQdpMWVm"
}

Corp Iarratais le Comhaid (ilchodach/foirm-shonraí)

curl -X POST https://eu.pwpush.com/api/v2/pushes \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "push[payload]=secret_password_123" \
  -F "push[expire_after_duration]=6" \
  -F "push[expire_after_views]=5" \
  -F "push[name]=Database Credentials" \
  -F "push[files][]=@/path/to/file1.pdf" \
  -F "push[files][]=@/path/to/file2.txt"

Nóta: Agus comhaid á gceangal agat, bain úsáid as multipart/form-data formáid agus socraigh kind: "file". Is féidir comhaid iolracha a cheangal ag baint úsáide as push[files][].

Paraiméadair

Paraiméadar	Cineál	Cur síos
`payload` ag teastáil	string	An téacs rúnda le roinnt
`expire_after_duration` roghnach	integer (0-17)	Uimhir fad (0-17)
`expire_after_views` roghnach	integer (1-100)	Líon na radharcanna roimh dhul in éag
`passphrase` roghnach	string	Éiligh frása faire le féachaint air
`name` roghnach	string	Ainm don bhrú
`note` roghnach	string	Nóta inmheánach (le feiceáil ag an cruthaitheoir amháin)
`deletable_by_viewer` roghnach	boolean	Lig do lucht féachana an bhrú a scriosadh
`retrieval_step` roghnach	boolean	Céim bhreise ag teastáil le haghaidh aisghabhála
`kind` roghnach	string	Clóscríobh: "téacs", "comhad", "url", nó "qr" (is é "téacs" an rogha réamhshocraithe)
`notify_emails_to` roghnach	string	Ríomhphoist faighteoirí: Liosta ceadanna Uathsheolta agus/nó Faighteoirí Fíordheimhnithe. Ní sheolann sé ríomhphost leis féin nuair a bhíonn notify_recipients bréagach.
`notify_emails_to_locale` roghnach	string	Logán (teanga) le fógra(í) ríomhphoist a sheoladh ann. Nuair a fhágtar ar lár é, úsáidtear an spás oibre réamhshocraithe, agus ansin an teanga réamhshocraithe don fheidhmchlár.
`notify_recipients` roghnach	boolean	Seol an nasc rúnda trí ríomhphost nuair a chruthaítear é (Seoladh Uathoibríoch). Nuair a fhágtar ar lár é, leanann sé an polasaí réamhshocraithe don spás oibre. Is fíor an réamhshocrú don chruthú gan ainm. Socraigh bréagach chun notify_emails_to a choinneáil mar liosta ceadanna gan an ríomhphost cruthaithe a sheoladh.
`authenticated_recipients` roghnach	boolean	Éilítear fíorú OTP ríomhphoist roimh fhéachaint. Éilítear notify_emails_to. Ní féidir é a aisghabháil ach sa bhrabhsálaí nuair a bhíonn sé cumasaithe (tuairisceán 403 i gcás aisghabhála API). Neamhspleách ar notify_recipients / Auto-Dispatch.
`workspace_id` roghnach	string	Aitheantas spás oibre réamhshocraithe (mar shampla `acct_oxQdpMWVm`Oidhreacht `account_id` agus glactar le haitheantais uimhriúla amha fós le haghaidh comhoiriúnachta siarghabhálach.

Luachanna Fad le haghaidh `expire_after_duration`

0: 15 nóiméad

1: 30 nóiméad

2: 45 nóiméad

3: 1 uair an chloig

4: 6 uair an chloig

5: 12 uair an chloig

6: 1 lá

7: 2 lá

8: 3 lá

9: 4 lá

10: 5 lá

11: 6 lá

12: 1 seachtain

13: 2 sheachtain

14: 3 seachtaine

15: 1 mhí

16: 2 mhí

17: 3 mhí

OSS vs Pro: Réimsí Éaga

Úsáideann Pro agus pwpush.com expire_after_duration (enum 0–17 thuas). Úsáideann an t-eagrán foinse oscailte expire_after_days (laethanta slánuimhir) ina ionad — ní thacaítear le expire_after_duration ansin agus déantar neamhaird de. Glactar leis an sean-expire_after_days fós ar Pro agus mapáiltear é chuig enum fad ama.

Réimsí Freagartha

Cuirtear na réimsí seo a leanas ar ais sa fhreagra agus brú á chruthú. Tabhair faoi deara: NÍ chuirtear ualach oibre agus comhaid ar ais nuair a chruthaítear iad—níl siad ar fáil ach amháin nuair a aisghabhtar brú trí GET.

Páirc	Cineál	Sampla	Cur síos
account_id	string or null	"acct_oxQdpMWVm"	Aitheantas spás oibre an úinéara (réimír). Ní chuirtear ar ais é ach amháin nuair a chruthaítear é nó nuair is féidir leat an brú a bhainistiú.
created_at	string	"2025-02-17T10:00:00.000Z"	Am cruthaithe ISO 8601
days_remaining	integer	1	Imithe i léig Laethanta iomlána fágtha (0 nuair < 1 lá); is fearr expires_at / expires_in
deletable_by_viewer	boolean	true	An féidir leis an bhfaighteoir an bhrú a scriosadh
deleted	boolean	false	Cibé acu ar scriosadh an bhrú go sainráite
expire_after_days	integer	1	Imithe i léig Laethanta measta (díorthaithe ó fhad)
expire_after_duration	integer	6	Uimhir fad (0–17); féach an tábla thuas
expire_after_views	integer	5	Uasmhéid radharcanna roimh dhul in éag
expired	boolean	false	Cibé an bhfuil an bhrú imithe in éag
expired_on	string or null	null	ISO 8601 nuair a chuaigh an bhrú in éag; neamhní mura bhfuil sé in éag
expires_at	string or null	"2025-02-18T10:00:00.000Z"	Am ISO 8601 nuair a théann an bhrú in éag; nialas má tá sé imithe in éag
expires_in	number	86400	Soicindí go dtí an dáta éaga (0 má tá an dáta éaga)
html_url	string	"https://.../p/abc"	URL le hoscailt sa bhrabhsálaí brúigh isteach
json_url	string	"https://.../p/abc.json"	URL chun brú a aisghabháil mar JSON
name	string or null	"Database credentials"	Ainm roghnach don bhrú
note	string or null	null	Nóta príobháideach roghnach
notify_emails_to	string or null	null	Ríomhphoist faighteoirí le haghaidh Seolta Uathoibríoch agus/nó Faighteoirí Fíordheimhnithe (préimh amháin)
notify_emails_to_locale	string or null	"en"	Teanga na ríomhphoist sin (préimh amháin). Réamhshocrú an spáis oibre, ansin réamhshocrú an fheidhmchláir, nuair a fhágtar ar lár é agus é á chruthú.
notify_recipients	boolean	true	Cibé an bhfuil Uathsheoladh cumasaithe. Is é seo an socrú stóráilte, ní admháil seachadta.
passphrase	string or null	null	I láthair ach amháin má tá frása faire ag an mbrú (luach i bhfolach)
retrieval_step	boolean	false	Cibé an bhfuil céim bhreise ag teastáil chun aisghabháil
updated_at	string	"2025-02-17T10:00:00.000Z"	Am nuashonraithe dheireanaigh ISO 8601
url_token	string	"fkwjfvhall92"	Aitheantóir rúnda uathúil don bhrú
views_remaining	integer	5	Radharcanna fágtha roimh dhul in éag

Freagra Samplach:

{
  "expire_after_duration": 6,
  "expire_after_views": 5,
  "expired": false,
  "url_token": "fkwjfvhall92",
  "deletable_by_viewer": true,
  "retrieval_step": false,
  "expired_on": null,
  "passphrase": null,
  "created_at": "2025-02-17T10:00:00.000Z",
  "updated_at": "2025-02-17T10:00:00.000Z",
  "expire_after_days": 1,
  "views_remaining": 5,
  "deleted": false,
  "days_remaining": 1,
  "expires_at": "2025-02-18T10:00:00.000Z",
  "expires_in": 86400,
  "json_url": "https://example.com/p/fkwjfvhall92.json",
  "html_url": "https://example.com/p/fkwjfvhall92",
  "account_id": "acct_oxQdpMWVm",
  "note": null,
  "name": "Database Credentials"
}

Iarratas Samplach

curl -X POST https://eu.pwpush.com/api/v2/pushes \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "push": {
      "payload": "MySecretPassword123",
      "expire_after_duration": 6,
      "expire_after_views": 3
    }
  }'

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

uri = URI('https://eu.pwpush.com/api/v2/pushes')
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 = {
  push: {
    payload: 'MySecretPassword123',
    expire_after_duration: 6,
    expire_after_views: 3
  }
}.to_json

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

import requests
import json

url = 'https://eu.pwpush.com/api/v2/pushes'
headers = {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
}
data = {
    'push': {
        'payload': 'MySecretPassword123',
        'expire_after_duration': 6,
        'expire_after_views': 3
    }
}

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

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

$body = @{
    push = @{
        payload = 'MySecretPassword123'
        expire_after_duration = 6
        expire_after_views = 3
    }
} | ConvertTo-Json -Depth 10

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

$response | ConvertTo-Json

GET /api/v2/pushes/:url_token

Aisghabhann sé ualach rúnda bhrú. Méadaíonn sé seo líon na radharcanna agus d’fhéadfadh sé go gcuirfeadh sé deireadh leis an mbrú.

Réimsí Freagartha

Cuirtear na réimsí seo a leanas ar ais agus brú á aisghabháil. Cuireann an críochphointe seo an t-ualach agus na comhaid nach bhfuil ar fáil ag críochphointí eile ar ais.

Páirc	Cineál	Sampla	Cur síos
created_at	string	"2025-02-17T10:00:00.000Z"	Am cruthaithe ISO 8601
days_remaining	integer	1	Imithe i léig Laethanta iomlána fágtha (0 nuair < 1 lá); is fearr expires_at / expires_in
deletable_by_viewer	boolean	true	An féidir leis an bhfaighteoir an bhrú a scriosadh
deleted	boolean	false	Cibé acu ar scriosadh an bhrú go sainráite
expire_after_days	integer	1	Imithe i léig Laethanta measta (díorthaithe ó fhad)
expire_after_duration	integer	6	Uimhir ré (0–17)
expire_after_views	integer	5	Uasmhéid radharcanna roimh dhul in éag
expired	boolean	false	Cibé an bhfuil an bhrú imithe in éag
expired_on	string or null	null	ISO 8601 nuair a chuaigh an bhrú in éag; neamhní mura bhfuil sé in éag
expires_at	string or null	"2025-02-18T10:00:00.000Z"	Am ISO 8601 nuair a théann an bhrú in éag; nialas má tá sé imithe in éag
expires_in	number	86400	Soicindí go dtí an dáta éaga (0 má tá an dáta éaga)
files	array	[{ filename, content_type, url }]	Meiteashonraí comhaid ceangailte le URLanna íoslódála
html_url	string	"https://.../p/abc"	URL le hoscailt sa bhrabhsálaí brúigh isteach
json_url	string	"https://.../p/abc.json"	URL chun brú a aisghabháil mar JSON
passphrase	string or null	null	I láthair ach amháin má tá frása faire ag an mbrú (luach i bhfolach)
payload	string or null	"secret123"	An t-ábhar rúnda; neamhní nuair a bheidh sé imithe in éag
retrieval_step	boolean	false	Cibé an bhfuil céim bhreise ag teastáil chun aisghabháil
updated_at	string	"2025-02-17T10:00:00.000Z"	Am nuashonraithe dheireanaigh ISO 8601
url_token	string	"fkwjfvhall92"	Aitheantóir rúnda uathúil don bhrú
views_remaining	integer	2	Radharcanna fágtha roimh dhul in éag

Iarratas Samplach

curl -X GET https://eu.pwpush.com/api/v2/pushes/fkwjfvhall92

Iarratas Samplach le Pasfrása

curl -X GET "https://eu.pwpush.com/api/v2/pushes/fkwjfvhall92" -H "X-Passphrase: your_passphrase"

Freagra Samplach

{
  "expire_after_duration": 6,
  "expire_after_views": 3,
  "expired": false,
  "url_token": "fkwjfvhall92",
  "deletable_by_viewer": false,
  "retrieval_step": false,
  "expired_on": null,
  "passphrase": null,
  "created_at": "2025-02-17T10:00:00.000Z",
  "updated_at": "2025-02-17T10:00:00.000Z",
  "expire_after_days": 1,
  "views_remaining": 2,
  "deleted": false,
  "days_remaining": 1,
  "expires_at": "2025-02-18T10:00:00.000Z",
  "expires_in": 86400,
  "json_url": "https://eu.pwpush.com/p/fkwjfvhall92.json",
  "html_url": "https://eu.pwpush.com/p/fkwjfvhall92",
  "payload": "MySecretPassword123",
  "files": []
}

Nóta: Má tá frása faire ag an mbrú, seol é leis an X-Passphrase ceanntásc (is fearr). An passphrase Glactar leis an bparaiméadar fós ar mhaithe le comhoiriúnacht, ach seachain rúin a chur in URLanna. Meastar gur radharc é aisghabháil brú agus féadfaidh sé an brú a chur in éag má shroicheann sé a theorainn radhairc.

GET /api/v2/pushes/:url_token/preview

Tugann sé URL rúnda láncháilithe brú ar ais gan an t-ualach a aisghabháil.

Iarratas Samplach

curl -X GET https://eu.pwpush.com/api/v2/pushes/fkwjfvhall92/preview

Freagra Samplach

{
  "url": "https://eu.pwpush.com/p/fkwjfvhall92"
}

GET /api/v2/pushes/:url_token/audit

Seolann sé an log iniúchta ar ais le haghaidh brú. Éilíonn sé fíordheimhniú agus úinéireacht.

Paraiméadair Iarratais:

page (roghnach): Uimhir leathanaigh le haghaidh uimhriú leathanaigh.

Réamhshocrú: 1 (an chéad leathanach)
Raon: 1 go 200
Tugann sé suas le 50 iontráil loga iniúchta ar ais in aghaidh an leathanaigh
Sampla: ?page=2 chun an dara leathanach a aisghabháil
Ceanntásca freagartha: Link, X-Page, X-Per-Page, X-Total, X-Total-Pages

Iarratas Samplach

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

Freagra Samplach

{
  "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"
    }
  ]
}

Nóta: An kind Léiríonn an réimse an cineál gníomhaíochta atá logáilte. Áirítear ar na luachanna coitianta: creation, view, expire, failed_passphrase, agus failed_view.

DELETE /api/v2/pushes/:url_token

Cuireann sé deireadh láithreach le brú agus scriosann sé go buan gach sonraí íogaire, lena n-áirítear an t-ualach agus aon chomhaid atá ceangailte. Ní féidir an gníomh seo a aisiompú agus ní féidir é a chealú. Éilíonn sé fíordheimhniú agus úinéireacht, nó ní mór don bhrú a bheith cruthaithe le deletable_by_viewer: true.

Iarratas Samplach

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

Freagra Samplach

{
  "expire_after_duration": 7,
  "expire_after_views": 5,
  "expired": true,
  "url_token": "fkwjfvhall92",
  "deletable_by_viewer": false,
  "retrieval_step": false,
  "expired_on": "2023-10-27T10:15:00.000Z",
  "passphrase": null,
  "created_at": "2023-10-27T10:00:00.000Z",
  "updated_at": "2023-10-27T10:15:00.000Z",
  "expire_after_days": 7,
  "days_remaining": 0,
  "expires_at": null,
  "expires_in": 0,
  "views_remaining": 0,
  "deleted": true,
  "json_url": "https://eu.pwpush.com/p/fkwjfvhall92.json",
  "html_url": "https://eu.pwpush.com/p/fkwjfvhall92",
  "account_id": "acct_oxQdpMWVm",
  "note": null,
  "name": null
}

GET /api/v2/pushes/active

Tugann sé liosta leathanaigh de do bhrúnna gníomhacha (neamh-éagtha) ar ais. Éilíonn sé fíordheimhniú.

GET /api/v2/pushes/expired

Tugann sé liosta leathanaigh de do bhrúnna atá imithe in éag ar ais. Éilíonn sé fíordheimhniú.

Paraiméadair Iarratais:

page (roghnach): Uimhir leathanaigh le haghaidh uimhriú leathanaigh.

Réamhshocrú: 1 (an chéad leathanach)
Raon: 1 go 200
Tuairisceáin suas le 50 brú in aghaidh an leathanaigh
Sampla: ?page=2 chun an dara leathanach a aisghabháil
Ceanntásca freagartha: Link, X-Page, X-Per-Page, X-Total, X-Total-Pages

Iarratas Samplach (Gníomhach)

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

Iarratas Samplach (In éag)

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

Freagra Samplach

[
  {
    "expire_after_duration": 7,
    "expire_after_views": 5,
    "expired": false,
    "url_token": "abc123xyz789",
    "deletable_by_viewer": false,
    "retrieval_step": false,
    "expired_on": null,
    "passphrase": null,
    "created_at": "2023-10-27T10:00:00.000Z",
    "updated_at": "2023-10-27T10:00:00.000Z",
    "expire_after_days": 7,
    "days_remaining": 7,
    "expires_at": "2023-10-29T10:00:00.000Z",
    "expires_in": 172800,
    "views_remaining": 5,
    "deleted": false,
    "json_url": "https://eu.pwpush.com/p/abc123xyz789.json",
    "html_url": "https://eu.pwpush.com/p/abc123xyz789",
    "account_id": "acct_oxQdpMWVm",
    "note": null,
    "name": null
  },
  {
    "expire_after_duration": 1,
    "expire_after_views": 3,
    "expired": false,
    "url_token": "def456uvw012",
    "deletable_by_viewer": true,
    "retrieval_step": false,
    "expired_on": null,
    "passphrase": null,
    "created_at": "2023-10-26T15:30:00.000Z",
    "updated_at": "2023-10-26T15:30:00.000Z",
    "expire_after_days": 1,
    "days_remaining": 0,
    "expires_at": "2023-10-26T16:00:00.000Z",
    "expires_in": 1200,
    "views_remaining": 2,
    "deleted": false,
    "json_url": "https://eu.pwpush.com/p/def456uvw012.json",
    "html_url": "https://eu.pwpush.com/p/def456uvw012",
    "account_id": "acct_oxQdpMWVm",
    "note": null,
    "name": null
  }
]

Nuashonraithe go deireanach: October 17, 2026

Password Pusher API leagan 2

Brúigh

Cruthaigh Brú

Corp Iarratais (JSON)

Corp Iarratais le Comhaid (ilchodach/foirm-shonraí)

Paraiméadair

Luachanna Fad le haghaidh `expire_after_duration`

OSS vs Pro: Réimsí Éaga

Réimsí Freagartha

Iarratas Samplach

Aisghabháil Brú

Réimsí Freagartha

Iarratas Samplach

Iarratas Samplach le Pasfrása

Freagra Samplach

Réamhamharc ar Bhrú

Iarratas Samplach

Freagra Samplach

Faigh Log Iniúchta Brúigh

Iarratas Samplach

Freagra Samplach

Brúigh a Dhéanamh in Éag

Iarratas Samplach

Freagra Samplach

Bailiúcháin Bhrúigh

Iarratas Samplach (Gníomhach)

Iarratas Samplach (In éag)

Freagra Samplach

Password Pusher API leagan 2

Brúigh

Cruthaigh Brú

Corp Iarratais (JSON)

Corp Iarratais le Comhaid (ilchodach/foirm-shonraí)

Paraiméadair

Luachanna Fad le haghaidh expire_after_duration

OSS vs Pro: Réimsí Éaga

Réimsí Freagartha

Iarratas Samplach

Aisghabháil Brú

Réimsí Freagartha

Iarratas Samplach

Iarratas Samplach le Pasfrása

Freagra Samplach

Réamhamharc ar Bhrú

Iarratas Samplach

Freagra Samplach

Faigh Log Iniúchta Brúigh

Iarratas Samplach

Freagra Samplach

Brúigh a Dhéanamh in Éag

Iarratas Samplach

Freagra Samplach

Bailiúcháin Bhrúigh

Iarratas Samplach (Gníomhach)

Iarratas Samplach (In éag)

Freagra Samplach

Luachanna Fad le haghaidh `expire_after_duration`