Password Pusher API v2

BETA

Documentação abrangente da API REST para integração Password Pusher nas suas aplicações

Aviso de Beta: A API v2 está atualmente em versão beta. Embora tenhamos feito todos os esforços para garantir a estabilidade, pode haver alterações significativas antes do lançamento final. Agradecemos o seu feedback!

Espaços de trabalho

Os espaços de trabalho são a forma como o Password Pusher organiza os envios e pedidos de equipas e indivíduos. Um utilizador pode pertencer a vários espaços de trabalho. Ao criar pushes ou pedidos, direccione um espaço de trabalho específico passando o parâmetro workspace_id com a identificação do espaço de trabalho.

Nota: Este parâmetro era anteriormente designado por account_id e renomeado para workspace_id. O legado account_id continua a ser aceite para efeitos de compatibilidade com versões anteriores.

Por defeito, tem um espaço de trabalho. No pwpush.com, pode criar espaços de trabalho adicionais para a sua equipa ou organização. No Self-Hosted Pro, apenas um espaço de trabalho é criado para si.

Listar espaços de trabalho com GET /api/v2/workspaces ou equivalente GET /api/v1/workspaces. Nas API v1 e v2, os caminhos antigos GET /api/v1/accounts e GET /api/v2/accounts devolvem o mesmo JSON.

GET /api/v2/workspaces

Pseudónimo herdado: GET /api/v2/accounts (resposta idêntica).

Devolve todos os espaços de trabalho a que o utilizador autenticado pertence. Utiliza a variável id como workspace_id ao criar pushes ou pedidos.

Exemplo de pedido

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

Exemplo de resposta

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

Campos de resposta

Campo	Tipo	Descrição
`id`	integer	ID numérico do espaço de trabalho. Passe este valor como `workspace_id` ao criar pushes ou pedidos.
`name`	string	Nome de apresentação do espaço de trabalho
`created_at`	string (ISO 8601)	Quando o espaço de trabalho foi criado
`updated_at`	string (ISO 8601)	Quando é que o espaço de trabalho foi atualizado pela última vez

Direcionar um espaço de trabalho

Ao criar pushes ou pedidos, pode opcionalmente passar workspace_id para associar o recurso a um espaço de trabalho específico. Se omitido, o recurso é criado no seu espaço de trabalho predefinido.

Nota: Este parâmetro era anteriormente designado por account_id e renomeado para workspace_id. O legado account_id continua a ser aceite para efeitos de compatibilidade com versões anteriores, mas as novas integrações devem utilizar workspace_id.

Importante: Só pode utilizar ids de espaços de trabalho a que pertence. A utilização do id de outro espaço de trabalho devolve 401 Unauthorized.