Katalog ve coğrafya

Yetki: catalog:read.

GET /api/v1/products

Ne satıldığı, anahtar sahibine özel fiyatla. Listede yalnızca şu anda satın alınabilenler bulunur; liste dışındaki bir slug 400 unknown_product ile yanıtlanır.

Alan	Anlamı
`slug`	hesaplama ve satın almada `product` içinde gönderilir: `residential`, `ipv4`
`family`	ürün türü: `traffic_gateway` (trafik) veya `dedicated` (sabit adresler)
`unit`	satış birimi: `gb` veya `ip`
`unit_price`	sizin için gigabayt fiyatı; `ipv4` için `null`, fiyat ülkeye ve döneme bağlıdır
`monthly_price_from`	`ipv4` için: sizin için bir adresin aylık en düşük fiyatı; trafikte `null`
`min_volume`, `volume_presets`, `volume_discounts`	trafik satın alma hacmi: minimum, arayüz için öneriler, yüzde cinsinden hacim kademeleri

Toplam tutarı hesaplayan: POST /api/v1/quote.

Ürün parametreleri

GET /api/v1/products/{product}/options - sabit adres satın alırken neler seçilebileceği. Trafik ürününde countries boştur: yalnızca hacimle satın alınır.

curl "https://ipv.rent/api/v1/products/ipv4/options" \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "type": "ipv4",
  "countries": [
    {
      "code": "us",
      "name": "United States",
      "periods": ["week", "2_weeks", "month", "2_months", "3_months"],
      "quantity_max": null,
      "plans": [
        {
          "id": "dc",
          "traffic_gb": null,
          "periods": ["week", "2_weeks", "month", "2_months", "3_months"],
          "operators": [
            {
              "id": "united-states",
              "name": "United States",
              "available": 374
            }
          ]
        }
      ]
    }
  ]
}

Alan	Satın almada nereye gider	Anlamı
`countries[].code`	`country`	ülke, ISO 3166-1 alpha-2
`countries[].periods`	`period`	ülkenin satıldığı süreler
`countries[].quantity_max`	`quantity`	tek satın almada kaç adres alınabileceği; `null` - ayrı bir sınır yok
`plans[].id`	`plan`	tarife; ülkede tek tarife varsa gönderilmeyebilir
`plans[].operators[].id`	`operator`	konum: tüm ülke veya bir şehir; zorunlu
`plans[].operators[].available`	-	konumda şu anda kaç adresin müsait olduğu

Parametreleri saklamak yerine her satın almadan önce yeniden okuyun: ülke listesi ve stoklar değişir.

Retler: 400 unknown_product (slug bilinmiyor veya ürün satılmıyor).

Geo kataloğu

Yalnızca Residential için: trafik paketinin hangi konumlardan çıkış yapabileceği. Dört seviye vardır ve her biri:

zorunlu product parametresini alır - bugün residential;
If-None-Match destekler ve gövdesiz 304 ile yanıt verir;
version döndürür ve kodlarda büyük/küçük harf ayrımı yapmaz.

ETag - sürümün opak bir özetidir; aynı sürümün okunabilir hali version alanıdır.

Rota	Parametreler	Yanıt
`GET /api/v1/geo/countries`	`product`	`code`, `name`, `pool` (`thin` \| `normal` \| `deep`) içeren `countries[]`
`GET /api/v1/geo/states`	`product`, `country`	`code` ve `name` içeren `states[]`
`GET /api/v1/geo/cities`	`product`, `country`, `state` (isteğe bağlı)	`code` ve `name` içeren `cities[]`
`GET /api/v1/geo/asns`	`product`, `country`	`code` ve `name` içeren `asns[]`

curl "https://ipv.rent/api/v1/geo/countries?product=residential" \
  -H 'Authorization: Bearer YOUR_API_KEY'

state olmadan cities ülkenin tüm şehirlerini döndürür. Artık hizmet verilmeyen bir ülke ret değil, boş liste döndürür.

Retler: 400 validation_failed (product veya country gönderilmedi), unknown_product (slug bilinmiyor veya ürün satılmıyor); 503 catalog_unavailable.

Bu yanıtlardaki kodlar, bağlantı oluşturma sırasında geo alanının kabul ettiği değerlerdir; katalog dışındaki bir değer 422 invalid_targeting alır.