REST API belgeleri

Acil arama REST API’leri

Bir numarayı ve hizmet adresini kaydedin, etkinleştirme durumunu izleyin ve konum değiştikçe kaydı güncel tutun.

Hesaba özel başvuru kaynağını aç Geliştirici ve Otomasyon

API’yi ve kimlik bilgisini birlikte seçin

Onaylı Geliştirici ve Otomasyon, İşletme ve İletişim Sağlayıcısı hesapları etkinleştirilmiş hizmetleri entegre edebilir. Bireysel bir geliştiricinin şirket gibi davranması gerekmez. Uygulama SMS/MMS’i için geçerli gönderim onayı ve kayıt gerekir. Bireyler ve aileler hizmetinde müşterinin erişebileceği, mesaj gönderimini başlatan bir API yoktur.

API ailesi	Temel URL	Kimlik doğrulama ve sonuç
İletişim v3	`https://api.multitel.net/v3`	Onaylı Basic kimlik bilgileri; uygun şekilde sağlanmış belirteçler yalnızca bunları destekleyen işlemlerde. JSON `status` ve `response`.
Acil durum kaydı	`https://api.multi.tel/emergency`	Onaylı Basic kimlik bilgileri veya özel olarak sağlanmış bearer erişimi. JSON `code`, `message` ve `data`.
Portal REST entegrasyonları	Hesabınızın geliştirici başvuru kaynağında gösterilen ana bilgisayar ve işlem	Bu işlemin belgelenmiş kimlik bilgisini, kapsamlarını ve şemasını kullanın. Tarayıcı oturumu istekleri ayrı bir erişim yoludur.

Örnekleri kullanmadan önce MULTITEL_API_USERNAME ve MULTITEL_API_PASSWORD değerlerini sunucunuzun gizli bilgi yapılandırması üzerinden ayarlayın. Bunları asla herkese açık tarayıcı JavaScript’ine, URL’lere veya kaynak denetimine eklemeyin. Özel kimlik bilgileri API Entegrasyonu ayarları bölümünde yönetilir.

Numara kaydetmeden kapsamı okuyun

curl --fail-with-body \
  --user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
  --header "Accept: application/json" \
  "https://api.multi.tel/emergency/coverage?environment=production"

https://api.multitel.net/emergency de desteklenir. Hiçbir acil durum temel URL’si /v3 içermez. Kapsam, uluslararası ülkeleri, desteklenen numara türlerini ve fiyatları listeler; Kuzey Amerika E911 uygunluğu kayıt sırasında kontrol edilir.

{
  "code": 200,
  "message": "",
  "environment": "production",
  "requestId": "EXAMPLE_REQUEST_ID",
  "data": {}
}

Bu yalnızca zarfı gösterir. Her işlemin data şemasını yayımlanmış acil durum API’si rehberinde okuyun.

Kaydedin, durumu izleyin, ardından aramayı yapılandırın

ABD/Kanada ve desteklenen diğer Kuzey Amerika E911 bölgeleri için numarayı, E911 adresini ve gerekli onay beyanlarını sağlayın. Kuzey Amerika E911 yalnızca üretim ortamındadır.
Desteklenen ve sahip olunan bir uluslararası numara için ya kayıtlı bir belge referansı ya da son kullanıcının kimliğini ve adresini sağlayın. Önce ülke ve numara türü gereksinimlerini inceleyin.
Bir adet POST /registrations isteği gönderin. İsteğe bağlı bir Idempotency-Key, mantıksal bir değişikliği tanımlar; yeniden denemeler boyunca onu ve aynı yükü (payload) koruyun.
GET /registrations/:number isteğini okuyun. Yaşam döngüsünü, pending ve actionRequired alanlarını inceleyin; gerekli düzeltmeleri yapın. Kabul edilmiş veya beklemede olmak, hizmetin etkin olduğu anlamına gelmez.
Etkinleştirmeden sonra doğru acil durum arayan kimliğini ve ülkeye özgü arama rotasını yapılandırın. Hizmetin acil olmayan doğrulama prosedürünü kullanın.

Uluslararası sandbox kayıtları yalıtılmıştır ve gerçek acil durum aramasını etkinleştirmez. Kuzey Amerika E911 için ana hesap kimlik bilgileri gerekir; rehber, sınırlı uluslararası alt hesap desteğini açıklar.

Portal kurulumu ve doğrulama Ülke kapsamı ve acil durum numaraları Eksiksiz herkese açık istekler, alanlar, durum ve yeniden deneme rehberi

Hataları ve yeniden denemeleri yönetme

Kimlik doğrulama veya yetki hatası: API kimlik bilgisinin etkin olup olmadığını, izin verilen hizmeti ve kaynak IP kısıtlamasını kontrol edin. Portal oturum çerezi bir entegrasyon kimlik bilgisi değildir.
Yetersiz kredi veya eksik onay: İşlemi tekrarlamadan önce hesap bakiyesi, gönderim onayı veya belge gereksinimini çözün.
Sonuç yok: Boş envanteri veya bulunamayan arayan adını olağan bir sonuç olarak ele alın. Sözdizimi geçerli bir numaranın her hizmete sahip olduğunu varsaymayın.
Ağ zaman aşımı veya hizmet hatası: Okuma işlemlerinde geri çekilmeli (backoff) ve sınırlı sayıda yeniden deneme kullanın. Satın alma, gönderim veya kayıt işlemlerinde önce işlemin durumunu inceleyin; kabul edilmiş bir isteği yeniden denemek faturalandırılabilir bir işlemin tekrarlanmasına yol açabilir.

Idempotency desteği her API ailesine özgüdür. Acil durum API’si yeniden deneme anahtarlarını destekler; bu, v3 isteklerinin keyfi olarak idempotent olduğu anlamına gelmez. Destek için zaman damgalarını, döndürülen kimlikleri ve bilgileri çıkarılmış yanıtları saklayın.

Hesabınızın referansıyla devam edin

Oturum açılmış referans, işlemleri izinlerinize ve etkinleştirilmiş hizmetlerinize göre filtreler. Onun belirttiği ana makine adını, kimlik bilgisi türünü, istek alanlarını ve yanıt şemasını aynen kullanın. Konsollar, satın alma ve mesaj gönderme dahil canlı işlemleri çalıştırabilir.

Hesaba özel uç nokta kataloğu İletişim REST konsolu Herkese açık iletişim OpenAPI belgesi OAuth entegrasyon kılavuzu