Password Pusher API v2

BETA

Documentação abrangente da API REST para integrar o Password Pusher nos seus fluxos de trabalho, aplicações e ferramentas.

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!

Visão geral

A API Password Pusher v2 fornece uma interface RESTful para criar, recuperar e gerir pedidos e envios de palavras-passe seguras. Todos os pontos de extremidade da API retornam respostas JSON e usam códigos de status HTTP padrão.

Autenticação de Token Portador

Acesso seguro à API com autenticação baseada em token

Respostas somente JSON

Formato JSON consistente em todos os pontos de extremidade

Conceção RESTful

Pontos de extremidade REST intuitivos seguindo as melhores práticas

Impulsos e pedidos

Suporte para envios unidireccionais e pedidos bidireccionais

GET /api/v2/version

Devolve a versão atual da API, os detalhes da aplicação e um hash de funcionalidades que descreve as capacidades activadas nesta instância.

Exemplo de pedido

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

Exemplo de resposta

{
  "application_version": "2.1.0",
  "api_version": "2.1",
  "edition": "commercial",
  "features": {
    "anonymous_access": true,
    "api_token_authentication": true,
    "accounts": {
      "enabled": true
    },
    "pushes": {
      "enabled": true,
      "email_auto_dispatch": true,
      "file_attachments": {
        "enabled": true,
        "requires_authentication": true
      }
    },
    "requests": {
      "enabled": true,
      "email_auto_dispatch": true,
      "file_attachments": {
        "enabled": true,
        "requires_authentication": true
      }
    }
  }
}

Caraterísticas Hash

acesso_anónimo - Se é permitida a utilização anónima da API

api_token_authentication - Suporte para autenticação de token de portador

contas.activadas - Se a listagem de espaços de trabalho está disponível em /api/v2/workspaces (o caminho antigo /api/v2/accounts é um alias)

pushes.enabled - Criação e gestão de push via API

pushes.email_auto_dispatch - Notificações por correio eletrónico sobre a criação de push

pushes.file_attachments.enabled - Anexos de ficheiros em pushes

pushes.file_attachments.requires_authentication - Os anexos de ficheiros requerem autenticação

requests.enabled - Criação e gestão de pedidos através de API

requests.email_auto_dispatch - Notificações por correio eletrónico sobre a criação de pedidos

requests.file_attachments.enabled - Anexos de ficheiros em respostas a pedidos

requests.file_attachments.requires_authentication - Os anexos de ficheiros requerem autenticação

Exemplo: Criar e recuperar um push

# Create a push
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
    }
  }'

# Retrieve the push
curl -X GET https://eu.pwpush.com/api/v2/pushes/fkwjfvhall92

Exemplo: Criar um pedido e responder

# Create a request
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 the API key",
      "close_after_duration": 8
    }
  }'

# Respond to the request
curl -X PATCH https://eu.pwpush.com/api/v2/requests/orpw2wkg00vpn0a/respond \
  -H "Content-Type: application/json" \
  -d '{
    "request": {
      "response": "The API key is: sk_live_1234567890"
    }
  }'

Estados do pedido

open O pedido foi criado e está à espera de uma resposta. Partilhe o URL do pedido com o destinatário.

ready Uma resposta foi fornecida e está disponível para recuperação. O requerente original pode agora aceder à resposta.

closed O pedido expirou ou foi encerrado manualmente. Todos os dados sensíveis foram eliminados de forma permanente.

Última atualização: July 12, 2026

Password Pusher API v2

Visão geral

Autenticação de Token Portador

Respostas somente JSON

Conceção RESTful

Impulsos e pedidos

Autenticação

Obter o seu token de API

URL de base

Disponibilidade Beta

Versão

GET /api/v2/version

Exemplo de pedido

Exemplo de resposta

Caraterísticas Hash

Exemplos completos

Exemplo: Criar e recuperar um push

Exemplo: Criar um pedido e responder

Estados do pedido

Tratamento de erros

Limites da taxa

Respostas de limite de taxa

Melhores Práticas