Kaynaklar

WareRushAI genel REST API (salt okunur)

Zapier, Make, n8n veya kendi kodunuzdan bir API anahtarı ile ürünlerinizi, stoğunuzu, siparişlerinizi, eksik verilerinizi ve pazaryeri hatalarınızı okuyun. OpenAPI 3.1 tanımı dahildir.

Revised:

1. Nedir?

WareRushAI REST API, diğer programların tek bir şirketin verilerini okumasını sağlar: ürünler, lokasyon başına stok, siparişler, eksik verili ürünler ve pazaryeri listeleme hataları. Bu sürümde salt okunurdur; web uygulaması ve MCP bağlayıcısı ile aynı servisler ve yetki kontrolleri üzerinde çalışır. Temel adres https://app.warerushai.com/api/v1 şeklindedir. API kademeli olarak kullanıma açılmaktadır: platform için etkinleştirilene kadar her çağrı 404 döndürür ve hiçbir anahtar oluşturulamaz.

2. API anahtarı oluşturma

Bir sahip veya yönetici Ayarlar'ı, ardından Entegrasyonlar'ı ve sonra API anahtarları'nı açar, anahtarı adlandırır, izinleri (catalog.read, inventory.read, orders.read, account.read), bir geçerlilik süresini ve dakika başına sınırı seçip anahtarı oluşturur. Tam anahtar wra_live_ ile başlar ve yalnızca bir kez gösterilir. WareRushAI yalnızca tek yönlü bir karma (hash) ve ilk karakterleri saklar; bu nedenle kaybolan bir anahtar kurtarılamaz: yeni bir anahtar oluşturun. Bir anahtarı istediğiniz zaman iptal edebilir veya döndürebilirsiniz (rotate): yeni anahtar bir kez gösterilir ve eski anahtar 24 saat boyunca çalışmaya devam eder.

3. Kimlik Doğrulama

Anahtarı HTTPS üzerinden Authorization başlığında gönderin: Authorization: Bearer wra_live_... Anahtarı asla web adresine koymayın; bunu yapan bir istek key_in_url ile reddedilir. Örnek: curl -H "Authorization: Bearer $WRA_KEY" "https://app.warerushai.com/api/v1/products?limit=20". MCP bağlayıcısının OAuth 2.1 erişim belirteçleri de kullanıcının onayladığı izinlerle kabul edilir.

4. Uç noktalar (Endpoints)

GET /me (anahtar, sınırları ve bugünkü kullanımı), GET /products (arama ve listeleme; query, limit, cursor ile), GET /products/{id}, GET /locations, GET /inventory (stok satırları, sayfalandırılmış), GET /inventory/summary, GET /orders (updated_since, status, source, limit, cursor ile), GET /missing-data ve GET /marketplace-errors (channel ile). Her uç nokta eşleşen izne ihtiyaç duyar: ürünler, eksik veriler ve pazaryeri hataları için catalog.read; lokasyonlar ve envanter için inventory.read; siparişler için orders.read. Yalnızca GET desteklenir; diğer yöntemler 405 döndürür.

5. Sayfalandırma ve yoklama (polling)

Listeler sayfa başına en fazla 50 öğe ile (limit 1 ila 50, varsayılan 20) data, next_cursor ve has_more döndürür. Sonraki sayfayı almak için next_cursor değerini cursor olarak geri iletin. Zapier, Make ve n8n yoklama (polling) tetikleyicileri için GET /orders?updated_since=2026-11-15T08:00:00Z çağrısını yapın ve son başarılı yoklamanızın zamanını saklayın: o andan itibaren oluşturulan veya değiştirilen siparişleri en yeniden eskiye doğru alırsınız.

6. Sınırlar ve hatalar

Her anahtarın dakika başına bir sınırı (varsayılan 60, en fazla 600) ve isteğe bağlı bir günlük sınırı vardır. Her şirketin ayrıca plana göre günlük bir kullanım hakkı bulunur: varsayılan olarak Starter için 1.000, Business için 10.000 ve Pro için 100.000 çağrı. Bir sınıra ulaşıldığında API bir Retry-After başlığıyla 429 yanıtı verir. X-RateLimit-Limit, X-RateLimit-Remaining, X-Daily-Limit ve X-Daily-Remaining başlıkları kalanı gösterir. Hatalar her zaman {"error":{"code","message","request_id"}} şeklindedir; destek ekibiyle iletişime geçtiğinizde request_id değerini belirtin. Yaygın kodlar: invalid_api_key (401), insufficient_scope (403), not_found (404), invalid_parameter (400), rate_limited ve daily_quota_exceeded (429).

7. OpenAPI tanımı

Makine tarafından okunabilir OpenAPI 3.1 tanımı https://app.warerushai.com/api/v1/openapi.json adresindedir ve anahtar gerektirmez. Tüm uç noktaları, parametreleri ve yanıt yapılarını almak için bunu Postman, Zapier, Make, n8n veya bir yapay zeka asistanına aktarın. Değişiklikler mevcut alanları bozmadan yapılır; sürüm /api/v1 şeklindedir.

8. Güvenlik

Anahtarlar yalnızca tek bir şirkete aittir ve her çağrıda kontrol edilir; bir anahtar asla başka bir şirketi okuyamaz ve onu oluşturan yönetici şirketten ayrılırsa çalışmayı durdurur. Anahtarlar asla günlüklerde veya hata mesajlarında görünmez ve çağrı günlüğü yalnızca yolu, durumu ve zamanı gösterir. Alış fiyatları gibi finansal veriler bu API tarafından sunulmaz.