Password Pusher API v2

BETA

Dokumentasi REST API yang komprehensif untuk mengintegrasikan Password Pusher ke dalam aplikasi Anda

Pemberitahuan Beta: API v2 saat ini dalam versi beta. Meskipun kami telah melakukan segala upaya untuk memastikan stabilitas, mungkin akan ada perubahan sebelum rilis final. Kami menerima umpan balik Anda!

Ruang kerja

Ruang kerja adalah cara Password Pusher mengatur dorongan dan permintaan untuk tim dan individu. Seorang pengguna bisa menjadi anggota beberapa ruang kerja. Saat membuat push atau permintaan, targetkan ruang kerja tertentu dengan meneruskan perintah workspace_id dengan id ruang kerja.

Catatan: Parameter ini sebelumnya bernama account_id dan berganti nama menjadi workspace_id. Warisan account_id masih diterima untuk kompatibilitas ke belakang.

Secara default, Anda memiliki satu ruang kerja. Di pwpush.com, Anda bisa membuat ruang kerja tambahan untuk tim atau organisasi Anda. Di Self-Hosted Pro, hanya satu ruang kerja yang dibuat untuk Anda.

Membuat daftar ruang kerja dengan GET /api/v2/workspaces atau yang setara GET /api/v1/workspaces. Dalam API v1 dan v2, jalur lama GET /api/v1/accounts dan GET /api/v2/accounts mengembalikan JSON yang sama.

GET /api/v2/workspaces

Alias warisan: GET /api/v2/accounts (respons yang identik).

Mengembalikan setiap ruang kerja milik pengguna yang diautentikasi. Gunakan setiap item id sebagai workspace_id saat membuat push atau permintaan.

Contoh Permintaan

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

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

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

request = Net::HTTP::Get.new(uri.path)
request['Authorization'] = 'Bearer YOUR_API_TOKEN'

response = http.request(request)
puts JSON.pretty_generate(JSON.parse(response.body))

import requests
import json

url = 'https://eu.pwpush.com/api/v2/workspaces'
headers = {
    'Authorization': 'Bearer YOUR_API_TOKEN'
}

response = requests.get(url, headers=headers)
print(json.dumps(response.json(), indent=2))

$headers = @{
    'Authorization' = 'Bearer YOUR_API_TOKEN'
}

$response = Invoke-RestMethod -Uri 'https://eu.pwpush.com/api/v2/workspaces' `
    -Method Get `
    -Headers $headers

$response | ConvertTo-Json -Depth 10

Contoh Tanggapan

[
  {
    "id": 1,
    "name": "My Personal Workspace",
    "created_at": "2023-10-27T10:00:00.000Z",
    "updated_at": "2023-10-27T10:00:00.000Z"
  },
  {
    "id": 2,
    "name": "Acme Corporation",
    "created_at": "2023-10-20T08:00:00.000Z",
    "updated_at": "2023-10-20T08:00:00.000Z"
  }
]

Bidang Tanggapan

Bidang	Tipe	Deskripsi
`id`	integer	Id numerik ruang kerja. Masukkan nilai ini sebagai `workspace_id` saat membuat push atau permintaan.
`name`	string	Menampilkan nama ruang kerja
`created_at`	string (ISO 8601)	Ketika ruang kerja dibuat
`updated_at`	string (ISO 8601)	Kapan ruang kerja terakhir kali diperbarui

Menargetkan ruang kerja

Saat membuat push atau permintaan, Anda dapat secara opsional meneruskan workspace_id untuk mengasosiasikan sumber daya dengan ruang kerja tertentu. Jika dihilangkan, sumber daya akan dibuat di ruang kerja default Anda.

Catatan: Parameter ini sebelumnya bernama account_id dan berganti nama menjadi workspace_id. Warisan account_id masih diterima untuk kompatibilitas ke belakang, tetapi integrasi baru harus menggunakan workspace_id.

Penting: Anda hanya dapat menggunakan id ruang kerja yang menjadi milik Anda. Menggunakan id ruang kerja lain akan mengembalikan 401 Unauthorized.