RESTful API'mizi kullanarak Telesto'yu kendi şirket içi çözümlerinizle veya üçüncü taraf hizmetlerle entegre edin. Özel entegrasyonlar ve otomatik iş akışları için idealdir.

Ön koşullar: Tüm uç noktalar için Pro abonelik ve geçerli bir API anahtarı gereklidir.

Kimlik Doğrulama

Tüm API istekleri, Authorization başlığında API anahtarınızla kimlik doğrulaması yapılmasını gerektirir:

Authorization: YOUR_API_KEY

Temel URL

https://telesto.app/v2

İstek Sınırları

  • IP adresi başına saatte 100 istek
  • İstek sınırı aşıldığında 15 dakikalık zaman aşımı
  • Tüm isteklerde Authorization başlığında API anahtarı bulunmalıdır

İstek sınırını aşmanız durumunda IP adresiniz geçici olarak 15 dakika boyunca engellenir.

Yanıt Formatı

Tüm yanıtlar JSON formatında döndürülür. Boş veya null alanlar, tutarlılık sağlamak amacıyla boş dize olarak döndürülür.

Başarılı Yanıt

{
    "id": "abc123...",
    "name": "My Product",
    "created": "2024-01-15 10:30:00"
}

Hata Yanıtı

{
    "statusCode": 401,
    "error": {
        "type": "UNAUTHORIZED",
        "description": "Invalid API key"
    }
}

Hata Kodları

Kod Tür Açıklama
401 UNAUTHORIZED API anahtarı eksik veya geçersiz
403 FORBIDDEN Pro abonelik gerekli
404 NOT_FOUND Kaynak bulunamadı
429 TOO_MANY_REQUESTS İstek sınırı aşıldı (15 dk bekleyin)
500 SERVER_ERROR Sunucu hatası, daha sonra tekrar deneyin

Hızlı Örnek

İstek

curl -X GET "https://telesto.app/v2/products" 
  -H "Authorization: YOUR_API_KEY"

Yanıt

[
    {
        "id": "a1b2c3...",
        "name": "Widget",
        "ean_upc": "123456789",
        "stock_onhand": "50",
        "created": "2024-01-15 10:30:00"
    }
]

En İyi Uygulamalar

  • API anahtarınızı güvenli bir şekilde saklayın (asla istemci tarafı kodunda tutmayın)
  • 429 (istek sınırı) yanıtları için yeniden deneme mantığı uygulayın
  • API çağrılarını azaltmak için yanıtları mümkün olduğunca önbelleğe alın
  • Tüm istekler için HTTPS kullanın

İpucu: İstek sınırları dahilinde kaldığınızdan emin olmak için entegrasyonunuzu önce küçük gruplar halinde test edin.

Tam Dokümantasyon

Ayrıntılı parametreler ve örnekler içeren eksiksiz API dokümantasyonuna aşağıdaki adresten ulaşabilirsiniz:

https://documenter.getpostman.com/view/3493/2s93Y2R1a8

Başlarken

  1. Pro aboneliğinizin olduğundan emin olun
  2. API erişimi talep etmek ve anahtarınızı almak için destek ekibiyle iletişime geçin
  3. Kullanılabilir uç noktalar (endpoint) için dokümantasyonu inceleyin

Şu anda Beta aşamasında: API uç noktalarını ve işlevlerini aktif olarak genişletiyoruz. API'yi kullanmak istiyorsanız veya belirli uç noktalara ihtiyacınız varsa lütfen destek ekibimizle iletişime geçin.