Get Tools Lab geliştirici API

API seçenekleri

Platform, API anahtarları, OAuth istemci kimlik bilgileri, kullanım analizleri, hız sınırları ve imzalı web kancası teslimi desteğiyle REST uç noktaları ve hafif bir GraphQL uyumlu katman içerir. Herkese açık web sitelerinin her özelliği API aracılığıyla otomatik olarak kullanıma sunulmayabilir.

Kimlik Doğrulaması

REST v1 uç noktaları, X-API-Key başlığı. Daha yeni uç noktalar, desteklenen taşıyıcı jetonları da kabul edebilir. Tüm kimlik bilgilerini gizli tutun ve açığa çıkması durumunda anahtarı hemen değiştirin.

curl -H "X-API-Key: qc_your_key" "https://gettoolslab.com/api/v1/tools.php"

Ortak REST uç noktaları

Araçlar

GET /api/v1/tools.php
GET /api/v1/tools.php?category=PDF
GET /api/v1/tools.php?q=json

Rehberler

GET /api/v1/guides.php
GET /api/v1/guides.php?q=image

REST v2 ve GraphQL

Birleştirilmiş geliştirici platformu, desteklenen kaynaklar için daha yeni REST rotalarını ve GraphQL işlemlerini kullanıma sunabilir. Mevcut dağıtımda gerçekten etkin olan uç noktaları görmek için geliştirici alanını ve API oyun alanını kullanın.

Hız limitleri

API istekleri dakika veya gün başına sınırlanabilir. Sınırını aşan bir istek HTTP döndürebilir 429 Too Many Requests yeniden deneme veya sıfırlama bilgisi ile birlikte. Uygulamalar, başarısız istekleri hemen tekrarlamak yerine geri alma yöntemini kullanmalıdır.

Web Kancaları

Desteklenen etkinlikler bir HTTPS web kancası hedefine teslim edilebilir. İmzalamanın etkinleştirildiği durumlarda veriye güvenmeden önce HMAC imzasını doğrulayın. Bir webhook tüketicisi ayrıca yeniden denemelere tolerans göstermeli ve aynı teslimatın yinelenen eylemler oluşturmaması için olay işlemeyi bağımsız hale getirmelidir.

Hatalar

Geçersiz kimlik bilgileri, devre dışı bırakılmış istemciler, tükenmiş kotalar veya hatalı biçimlendirilmiş istekler, HTTP 4xx durum kodlarıyla yapılandırılmış JSON hataları döndürebilir. Sunucu tarafı arızalarında 5xx yanıtları kullanılır. Uygulamalar, hata raporlarında gizli kimlik bilgilerini açığa çıkarmak yerine, mümkün olduğunda yanıt durumunu ve istek tanımlayıcısını günlüğe kaydetmelidir.

Güvenlik guidance

• Gizli API anahtarlarını hiçbir zaman genel tarayıcı JavaScript'ine yerleştirmeyin.
• API ve webhook trafiği için HTTPS kullanın.
• İstemcilere yalnızca ihtiyaç duydukları izinleri verin.
• Webhook imzalarını doğrulayın.
• Güvenliği ihlal edilmiş kimlik bilgilerini döndürün.
• Belgelenen hız sınırlarına ve dosya boyutu sınırlarına uyun.

SDK'lar ve oyun alanı

SDK örnekleri ve interaktif oyun alanı için Geliştirici bölümünü ziyaret edin. Üretim dosyalarını veya müşteri bilgilerini kullanmadan önce hassas olmayan verilerle entegrasyonları test edin.