Identity verification anahtarları

JWT identity verification için app başına ES256 genel anahtarları (kid); SDK login belirteçlerini sunucunuz bu anahtarların özel yarısıyla imzalar.

Taban adres: https://api.pushizo.com · Etiket: identity-keys · Etkileşimli belge (Scalar)

İşlemlerBağlantıyı kopyala

AyrıntılarBağlantıyı kopyala

SDK kimlik doğrulama (JWT) genel anahtarlarıBağlantıyı kopyala

Kimlik doğrulama: API anahtarı — kapsam admin (admin her kapsamı içerir).

Parametreler

Yanıtlar

200 — Başarılı.Bağlantıyı kopyala

Şema: IdentityKeyList

Örnek yanıt:

{
  "data": [
    {
      "id": "key_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "kid": "key-2026-10",
      "alg": "ES256",
      "public_jwk": {
        "key": "user_42"
      },
      "label": "external_id",
      "created_at": "örnek",
      "revoked_at": "örnek"
    }
  ]
}

Hata yanıtları ortak zarfla döner (error.code, message, details, request_id): hata kataloğu. Tüm yanıtlar X-RateLimit-* başlıklarını taşır (hız sınırları).

Örnekler

curl -X GET "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/identity-keys" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Genel anahtar ekle (ES256)Bağlantıyı kopyala

SDK JWT identity verification için ES256 (EC P-256) genel anahtarı ekler; özel anahtar gönderilmez. Belirteç sunucunuzda imzalanır (sub = external_id, aud = app_id, exp ≤ 24 saat) ve SDK isteklerinde Authorization: Bearer <jwt> başlığıyla taşınır. Kip app ayarında identity_verification_mode ile seçilir.

Kimlik doğrulama: API anahtarı — kapsam admin (admin her kapsamı içerir).

Parametreler

İstek gövdesi (zorunlu)

Şema: CreateIdentityKeyDto

Örnek:

{
  "kid": "key-2026-10",
  "label": "external_id",
  "public_jwk": {
    "key": "örnek"
  },
  "public_key_pem": "örnek"
}

Yanıtlar

201 — Başarılı.Bağlantıyı kopyala

Şema: IdentityKey

Örnek yanıt:

{
  "id": "key_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "kid": "key-2026-10",
  "alg": "ES256",
  "public_jwk": {
    "key": "user_42"
  },
  "label": "external_id",
  "created_at": "örnek",
  "revoked_at": "örnek"
}

Hata yanıtları ortak zarfla döner (error.code, message, details, request_id): hata kataloğu. Tüm yanıtlar X-RateLimit-* başlıklarını taşır (hız sınırları).

Örnekler

curl -X POST "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/identity-keys" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "kid": "key-2026-10",
  "label": "external_id",
  "public_jwk": {
    "key": "örnek"
  },
  "public_key_pem": "örnek"
}'

Genel anahtarı iptal etBağlantıyı kopyala

Kimlik doğrulama: API anahtarı — kapsam admin (admin her kapsamı içerir).

Parametreler

Yanıtlar

200 — Başarılı.Bağlantıyı kopyala

Şema: IdentityKey

Örnek yanıt:

{
  "id": "key_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "kid": "key-2026-10",
  "alg": "ES256",
  "public_jwk": {
    "key": "user_42"
  },
  "label": "external_id",
  "created_at": "örnek",
  "revoked_at": "örnek"
}

Hata yanıtları ortak zarfla döner (error.code, message, details, request_id): hata kataloğu. Tüm yanıtlar X-RateLimit-* başlıklarını taşır (hız sınırları).

Örnekler

curl -X DELETE "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/identity-keys/key_01JD3W5Q7X9K2M4N6P8R0T1V3W" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"