Hesap ve proje erişimi
İzin verilen bir IP adresinden, HTTPS üzerinden etkin bir API hesabı kullanın. Proje bu hesaba ait olmalı ve silinmiş olmamalıdır. Projenin sayısal veritabanı kimliği veya bir telefon numarası yerine, numara taşıma siparişi iş akışındaki benzersiz proje kimliğini kullanın. İstek oluştururken proje kimliğine URL kodlaması uygulayın.
İstek
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/events"Yanıt
Kurgusal yanıt örneği.
{
"status": {
"code": 200,
"msg": "Project Events",
"results": 1
},
"response": [
{
"id": 31,
"subject": "Example project update",
"event": "{\"type\":\"comment\",\"value\":\"Example update\",\"source\":\"Example source\"}",
"type": "comment",
"value": "Example update",
"source": "Example source",
"date_created": "2026-10-23 12:00:00"
}
]
}Olayı bulunmayan mevcut bir proje, 200 API kodunu, boş bir listeyi ve şu alanı döndürür: status.results; bu alanın değeri 0 olur. Sonuçlar oluşturulma zamanına göre azalan sırada istenir; aynı zamana sahip kayıtlar için ek sıralama, sayfalama, imleç veya tarih filtresi yoktur.
Olay verilerini dikkatle yorumlayın
id olay satırının sayısal kimliğidir; subject saklanan konusudur; date_created ise saklanan tarih/saat değeridir. Uç nokta, ham event dizesini korur ve ayrıca bu dizedeki şu alanları çözümlemeyi dener: type, value ve source. Olay verisi bir JSON nesnesi değilse veya bir özellik eksikse ilgili ayrıştırılmış alan boş bir dize olur.
Olay verisi, sabit bir numaralandırılmış değer kümesi değildir ve düz metin şemasına uyacağı garanti edilmez. Kaynak metnini doğrulanmış bir kimlik olarak kabul etmeyin ve olay içeriğini HTML olarak görüntülemeyin. Ham olayları yetkilendirilmiş sunucu tarafı iş akışlarında tutun ve yetkili kullanıcılara yalnızca uygun metni gösterin. Bu uç noktada personel ve müşteriler için ayrı bir olay görünürlüğü filtresi veya içerik maskeleme özelliği yoktur.
Geçmiş, işlemin gerçekleşeceğini garanti etmez
Bu, saklanan proje geçmişidir; bir webhook akışı, değiştirilemez bir eşitleme imleci veya her veritabanı değişikliğinin eksiksiz kaydı değildir. Örneğin, incelenen numara ekleme işleyicisi üzerinden numara eklemek tek başına bir olay oluşturmaz. Olayları okumanın yanı sıra numara listesini ve durumlara göre kayıt sayılarını da karşılaştırarak tutarlılıklarını kontrol edin.
Hatalar ve sınırlamalar
Hem HTTP yanıtını hem de şu alanları kontrol edin: status.code/status.msg. Mevcut olmayan, silinmiş veya hesaba ait olmayan bir proje, projenin bulunamadığını belirten bir mesajla birlikte 404 API kodunu döndürür. Kimlik doğrulama ve kaynak IP kısıtlamaları da geçerlidir. Örnekler canlı bir istek göndermez; başarılı bir yanıt, operatörün numara taşıma işlemini kabul ettiğinin veya tamamladığının kanıtı değildir.
Etkiler
İncelenen işleyici saklanan olayları okur; projeyi değiştirmez, numara taşıma işlemi başlatmaz veya hesaptan ücret düşmez. Olay yazıcılarının görünürlüğü ve kimliği doğrulanmış hesapla yapılacak testler, bekleyen sözleşme incelemesinin bir parçası olmaya devam etmektedir.