Entegrasyon kılavuzu

Bağlantıyı uygulama sunucunuzdan yapın. Anahtarı tarayıcıya koymayın. Hizmet ve fiyat listeleri gerçek satın alma durumunu gösterir.

OpenAPI 3.1 JSON
İşlem ve hizmet grubu izinleri açıkça seçilmelidir. Anahtar uygulamanız, izinli IP, süre sonu ve harcama limitiyle sınırlıdır. Bağlantı kesilirse durumu aynı istek anahtarıyla alın. Belirsiz deneme için yeni anahtar oluşturmayın.

curl

curl https://servernet.cloud/api/v1/identity/services \
  -H "Authorization: Bearer $SERVERNET_API_KEY"

curl -X POST https://servernet.cloud/api/v1/identity/inquiries/shahkar-inquiry \
  -H "Authorization: Bearer $SERVERNET_API_KEY" \
  -H "Idempotency-Key: $REQUEST_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @request.json

{
  "input": {"mobile": "YOUR_AUTHORIZED_MOBILE", "national_code": "YOUR_AUTHORIZED_NATIONAL_CODE"},
  "max_charge_irt": 0,
  "price_version": 0
}

Örnekteki sıfırları kabul ettiğiniz sınır ve katalogdaki gerçek fiyat sürümüyle değiştirin. Bunlar gerçek fiyat değildir.

PHP / Laravel

$response = Http::withToken(env('SERVERNET_API_KEY'))
    ->withHeaders(['Idempotency-Key' => $savedRequestKey])
    ->timeout(40)->post(
        'https://servernet.cloud/api/v1/identity/inquiries/shahkar-inquiry',
        ['input' => $authorizedInput, 'max_charge_irt' => $acceptedQuote,
         'price_version' => $priceVersion]
    );

Python

import os, requests

response = requests.post(
    "https://servernet.cloud/api/v1/identity/inquiries/shahkar-inquiry",
    headers={"Authorization": "Bearer " + os.environ["SERVERNET_API_KEY"],
             "Idempotency-Key": saved_request_key},
    json={"input": authorized_input, "max_charge_irt": accepted_quote,
          "price_version": price_version}, timeout=40)
result = response.json()

JavaScript (Node.js)

const response = await fetch(
  'https://servernet.cloud/api/v1/identity/inquiries/shahkar-inquiry', {
    method: 'POST',
    headers: {'Authorization': `Bearer ${process.env.SERVERNET_API_KEY}`,
      'Idempotency-Key': savedRequestKey, 'Content-Type': 'application/json'},
    body: JSON.stringify({input: authorizedInput,
      max_charge_irt: acceptedQuote, price_version: priceVersion})
  });
const result = await response.json();

Durumlar

İşleme, sorgu sonucu ve mali durum bağımsızdır. HTTP 202 işleme veya mutabakat gerektirebilir. 402 bakiye/bütçe, 403 izin, 409 anahtar/fiyat çakışması, 429 hız veya eşzamanlılık sınırıdır.

Belirsiz sonuçta rezervasyon kabulden itibaren en fazla 15 dakika tutulur. Bu sürede güvenilir kanıt yoksa serbest bırakılır ve sonradan tek taraflı ücret alınmaz. Yanlış kesintiler düzeltilir; rezervasyon iadesi nakit çekim değildir.

GET /api/v1/identity/requests/{request_id}

İstek anahtarı uygulama ve işlem kapsamında benzersizdir. Aynı girdi aynı makbuzu döndürür; farklı girdi çakışır. Sonuç silindikten sonra kullanılmış anahtar yeni satın almaya dönüşmez.