Başlangıç
Temel adres: https://viatelekom.com.tr/api/v1. İstekler HTTPS üzerinden JSON gövdeyle yapılır; yanıtlar application/json döner. Tarihler ISO 8601 (UTC), tutarlar kuruş cinsinden tam sayıdır ve okunabilir karşılığı *_formatted alanında gelir.
- Panelde hesabınızı oluşturup bakiye yükleyin.
- API anahtarları sayfasından gereken kapsamlarla anahtar üretin (gizli kısım yalnız bir kez gösterilir).
- İlk isteğinizi atın:
GET /me.
Bağlantıyı doğrulayın
curl "https://viatelekom.com.tr/api/v1/me" \
-H "Authorization: Bearer vt_live_xxxxxxxx.GIZLI_ANAHTARINIZ"Kimlik doğrulama
Her istekte Authorization: Bearer <önek>.<gizli> başlığı gönderilir. Önek (ör. vt_live_8f3k2m1q) açıktır ve panelde görünür; gizli kısım yalnızca anahtar oluşturulurken gösterilir ve sunucularımızda yalnız özeti (SHA-256) saklanır. Anahtarı istemci tarafı koda veya mobil uygulamaya gömmeyin.
- IP izin listesi: anahtarı yalnız belirli sunucu adreslerinden kullanılabilir yapın.
- Numara kısıtı: anahtarı seçili numaralarla sınırlayın; diğer numaralar
404döner. - Son kullanma tarihi: geçici entegrasyonlar için süreli anahtar üretin.
Kapsamlar
| Kapsam | İzin verilen işlemler |
|---|---|
numbers:read | Numaraları, katalogu ve fiyat tekliflerini görüntüleme |
numbers:write | Numara kiralama, yenileme, değiştirme, hizmet ekleme/kaldırma ve ayar güncelleme |