Password Pusher API верзије 2

BETA

Свеобухватна REST API документација за интеграцију Password Pusher-а у ваше токове рада, апликације и алате.

Обавештење о бета верзији: API v2 је тренутно у бета верзији. Иако смо уложили све напоре да обезбедимо стабилност, могуће су значајне промене пре финалног издања. Ценимо ваше повратне информације!

Преглед

Password Pusher API v2 пружа RESTful интерфејс за креирање, преузимање и управљање безбедним слањем лозинки и захтевима. Све крајње тачке API-ја враћају JSON одговоре и користе стандардне HTTP статусне кодове.

Аутентификација носиоца токена

Безбедан API приступ са аутентификацијом заснованом на токенима

Само JSON одговори

Доследан JSON формат на свим крајњим тачкама

RESTful дизајн

Интуитивне REST крајње тачке које прате најбоље праксе

Захтеви и поруке

Подршка за једносмерне и двосмерне захтеве

GET /api/v2/version

Враћа тренутну верзију API-ја, детаље апликације и хеш функција који описује које су могућности омогућене на овој инстанци.

Пример захтева

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

Пример одговора

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

Хеш карактеристика

анонимни_приступ - Да ли је дозвољено коришћење анонимног API-ја

API_токен_аутентификација - Подршка за аутентификацију токена носиоца

налози.омогућени - Да ли је листа радних простора доступна на /api/v2/workspaces (стара путања /api/v2/accounts је псеудоним)

pushes.enabled - Креирање и управљање порукама путем API-ја

pushes.email_auto_dispatch - Обавештења имејлом о креирању push порука

pushs.file_attachments.enabled - Прилози датотека приликом слања

pushs.file_attachments.requires_authentication - Прилози датотека захтевају аутентификацију

захтеви.омогућено - Креирање и управљање захтевима путем API-ја

захтеви.е-пошта_аутоматско_слање - Обавештења е-поштом о креирању захтева

requests.file_attachments.enabled - Прилози у датотекама уз одговоре на захтев

захтеви.прилози_файлова.захтева_аутентификацију - Прилози датотека захтевају аутентификацију

Пример: Креирање и преузимање поруке

# Create a push
curl -X POST https://us.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://us.pwpush.com/api/v2/pushes/fkwjfvhall92

Пример: Креирајте захтев и одговорите

# Create a request
curl -X POST https://us.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://us.pwpush.com/api/v2/requests/orpw2wkg00vpn0a/respond \
  -H "Content-Type: application/json" \
  -d '{
    "request": {
      "response": "The API key is: sk_live_1234567890"
    }
  }'

Захтевне државе

open Захтев је креиран и чека одговор. Поделите URL захтев са примаоцем.

ready Одговор је дат и доступан је за преузимање. Првобитни подносилац захтева сада може да приступи одговору.

closed Захтев је истекао или је ручно затворен. Сви осетљиви подаци су трајно избрисани.

Ограничавање брзине је имплементирано како би се заштитио API од злоупотребе и осигурала фер употреба за све кориснике. Ограничења брзине се примењују по IP адреси и варирају у зависности од типа захтева и крајње тачке.

Одговори на ограничење брзине

Када захтев пређе ограничење брзине, API враћа 429 Too Many Requests статусни код са Retry-After заглавље које показује када можете поново покушати захтев.

Најбоље праксе

Имплементирајте експоненцијално одлагање када добијете одговор 429
Поштујте Retry-After вредност заглавља
Кеширајте одговоре када је то потребно да бисте смањили API позиве
Групне операције када је то могуће уместо подношења много појединачних захтева
Пратите коришћење API-ја ваше апликације како бисте избегли прекорачење ограничења

Напомена: Ограничења брзине су осмишљена да спрече злоупотребу, а истовремено омогуће легитимну употребу. Ако стално наилазите на ограничења брзине, размислите о оптимизацији интеграције или контактирању подршке да бисте разговарали о свом случају употребе.

Последње ажурирање: July 20, 2026

Password Pusher API верзије 2

Преглед

Аутентификација носиоца токена

Само JSON одговори

RESTful дизајн

Захтеви и поруке

Аутентификација

Добијање вашег API токена

Основни URL

Доступност бета верзије

Верзија