Password Pusher API v2

베타

통합을 위한 포괄적인 REST API 문서 Password Pusher 애플리케이션에 적용

베타 공지: API v2는 현재 베타 버전입니다. 안정성을 보장하기 위해 최선을 다하고 있지만 최종 릴리스 전에는 획기적인 변경 사항이 있을 수 있습니다. 여러분의 피드백을 환영합니다!

작업 공간

작업 영역은 비밀번호 푸셔가 팀과 개인을 위한 푸시 및 요청을 구성하는 방식입니다. 사용자는 여러 개의 작업 공간에 속할 수 있습니다. 푸시 또는 요청을 만들 때 특정 워크스페이스를 대상으로 지정하려면 workspace_id 매개변수를 워크스페이스 ID와 함께 설정합니다.

참고: 이 매개 변수의 이전 이름은 account_id 로 이름이 변경되었습니다 workspace_id. 레거시 account_id 이름은 이전 버전과의 호환성을 위해 계속 사용할 수 있습니다.

기본적으로 하나의 워크스페이스가 있습니다. Pwpush.com에서 팀 또는 조직을 위한 워크스페이스를 추가로 만들 수 있습니다. 셀프 호스팅 프로에서는 워크스페이스가 하나만 생성됩니다.

다음을 사용하여 작업 공간을 나열합니다 GET /api/v2/workspaces 또는 이에 상응하는 GET /api/v1/workspaces. API v1 및 v2에서는 레거시 경로인 GET /api/v1/accounts 그리고 GET /api/v2/accounts 동일한 JSON을 반환합니다.

GET /api/v2/workspaces

레거시 별칭: GET /api/v2/accounts (동일한 응답).

인증된 사용자가 속한 모든 워크스페이스를 반환합니다. 각 항목의 id as workspace_id 푸시 또는 요청을 만들 때

요청 예시

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

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

uri = URI('https://us.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://us.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://us.pwpush.com/api/v2/workspaces' `
    -Method Get `
    -Headers $headers

$response | ConvertTo-Json -Depth 10

응답 예시

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

응답 필드

필드	유형	설명
`id`	integer	워크스페이스의 숫자 ID입니다. 이 값을 다음과 같이 전달합니다 `workspace_id` 푸시 또는 요청을 만들 때
`name`	string	워크스페이스의 표시 이름
`created_at`	string (ISO 8601)	워크스페이스가 만들어졌을 때
`updated_at`	string (ISO 8601)	워크스페이스가 마지막으로 업데이트된 시기

워크스페이스 타겟팅

푸시 또는 요청을 만들 때 선택적으로 다음을 전달할 수 있습니다 workspace_id 를 입력하여 리소스를 특정 워크스페이스에 연결합니다. 생략하면 리소스가 기본 워크스페이스에 만들어집니다.

참고: 이 매개 변수의 이전 이름은 account_id 로 이름이 변경되었습니다 workspace_id. 레거시 account_id 이름은 이전 버전과의 호환성을 위해 여전히 허용되지만 새로운 통합은 workspace_id.

중요: 자신이 속한 워크스페이스 ID만 사용할 수 있습니다. 다른 워크스페이스의 ID를 사용하면 다음과 같이 반환됩니다 401 Unauthorized.