Satın alınmış tek bir numarayı okuyun

Satın alınmış tek bir numaranın kaydını ve kayıtlı yapılandırmasını okuyun. Bu işlem, inventory uç noktasının döndürdüğü dizi yerine bir nesne döndürür.

İstek

HTTPS üzerinden sunucu tarafındaki API kimlik bilgilerini kullanın. Örnekler kimlik bilgilerini ortam değişkenlerinden okur; geçerli kimlik bilgileri içermezler. JSON gövdesindeki status.code değerini HTTP durumuyla birlikte inceleyin. Bu eski işleyiciler, uygulama hataları için her zaman bir HTTP hata durumu ayarlamaz.

curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
  "https://api.multitel.net/v3/numberinfo/12025550100"

Gerekli yol bölümü, kayıtlı uluslararası telefon numarasıdır; numaranın UUID değeri veya bir PBX dahili numarası değildir. Bu işleyici sorgu parametreleri veya istek gövdesi kullanmaz.

Yanıt

Bu, yanıt yapısını gösteren bir örnektir; hesap verisi veya güncel bir fiyat teklifi değildir.

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "12025550100",
    "uuid": "NUMBER_UUID",
    "description": "Main reception",
    "isocode": "US",
    "config": {
      "uri": "sip:reception@example.com",
      "uri2": "",
      "uri3": "",
      "forward_destination": "",
      "sms_uri": "",
      "sms_forward_destination": ""
    },
    "features": {
      "voice": "1",
      "sms": "1",
      "mms": "0"
    },
    "status": {
      "capacity": {
        "assigned_channels": "2",
        "used_channels": "0",
        "overflow": "0",
        "overage_charge": "0.01"
      },
      "origination": {
        "origination_trunk_id": "ORIGINATION_ID",
        "origination_trunk_name": "ORIGINATION_NAME",
        "origination_country_iso": "US",
        "origination_continent_iso": "NA",
        "origination_continent_name": "North America"
      },
      "service_active": "1",
      "force_codec": "",
      "force_dtmf": ""
    },
    "billing": {
      "cnam": "0",
      "overflow": "0",
      "autorenew": "1",
      "persistent": "0",
      "date_created": "2026-01-01 00:00:00"
    },
    "price": {
      "setup_price": "0.00",
      "monthly_price": "1.00",
      "per_minute": "0.01",
      "free_minutes": "0",
      "remaining_minutes": "0",
      "perminute_charges": "0"
    },
    "needs_registration": "0",
    "vrating": "",
    "country_id": "COUNTRY_REFERENCE",
    "area_id": "AREA_REFERENCE",
    "provider_id": "OPAQUE_LEGACY_REFERENCE"
  }
}

Döndürülen numara alanları
Alan	Anlamı
`number, uuid, description, isocode`	Kayıtlı telefon numarası, içeriğinden anlam çıkarılmaması gereken numara tanımlayıcısı, açıklama ve ülke kodu.
`config`	Kayıtlı sesli arama hedefleri, harici yönlendirme, SMS hedefi ve SMS yönlendirme alanları. Bu uç nokta bu alanları düzenlemez.
`features`	Kayıtlı sesli arama, SMS ve MMS yetenek bayrakları. Eski sistemden kalan kayıtlı bayrakların JSON mantıksal değerleri olması garanti edilmez.
`status.capacity`	Atanan ve kullanılan kanal değerleri, taşma ayarı ve kayıtlı aşım ücreti. Bunlar kayıtlı üst verilerdir; yeni bir kapasite teklifi veya canlı arama testi değildir.
`status.origination`	Kayıtlı çağrı kaynaklandırma üst verileri. Tanımlayıcıların içeriğinden anlam çıkarmayın; dahili adlardan uygulama mantığı türetmeyin.
`status.service_active, force_codec, force_dtmf`	Kayıtlı etkinleştirme ve medya yapılandırma alanları. Tek başına bir bayrak, gelen trafiğin başarıyla iletildiğini kanıtlamaz.
`billing`	Kayıtlı CNAM, taşma, yenileme, kalıcılık ve oluşturulma değerleri. Bunları okumak, yenileme veya diğer faturalandırma ayarlarını değiştirmez.
`price`	Kayıtlı kurulum, aylık ve dakika başına fiyatlar ile dakika hakları. İşleyici, para birimi alanı veya yeni bir fiyat teklifi sağlamaz. Örnek değerlerden para birimi çıkarmayın veya bunları güncel bir satın alma fiyat teklifi olarak kullanmayın.

Karşılaştırma için inventory, bu uç noktanın ayrıca döndürdüğü alanlar şunlardır: needs_registration, vrating, country_id, area_id, provider_id ve price.perminute_charges. Bunlar eski sistemden kalan kayıtlı değerlerdir; ayrı bir kimlik onayı yanıtı değildir. Referans kimliklerinin içeriğinden anlam çıkarılmamalıdır; uygun keşif yanıtı olmadan bunlardan keşif URL'leri oluşturmayın veya sağlayıcı eşleştirmeleri çıkarmayın.

Eşleşen numara yok

Kimliği doğrulanmış hesap için eşleşen ve geçersiz kılınmamış bir kayıt bulunamazsa JSON gövdesindeki status.code değeri 404 olur ve şu ifadeyi içeren bir mesaj bulunur: number not found. Mesajın sonundaki kaynak satırı ekine güvenmeyin. Yeniden denemeden önce kayıtlı numarayı ve inventory verilerini kontrol edin.

Sonucu kullanın

Bu işlem kayıtlı verileri okur. Numara satın almaz, kimlik belgelerini onaylamaz, bir hedefi değiştirmez veya bir aramanın, faksın ya da mesajın iletileceğini garanti etmez. Bir numarayı yapılandırırken etkinleştirilen her hizmeti ayrı ayrı test edin.