AlwaysCompleted API'si ile geliştirin

Hizmetleri almak, sipariş vermek ve ilerlemeyi takip etmek için AlwaysCompleted'ı sunucu tarafındaki iş akışınıza bağlayın. Bu rehber, ilk salt okunur isteğinizden sipariş oluştururken önemli olan kontrollere kadar size yol gösterir. Parametrelerin tam listeleri ve yanıt örnekleri için API referansını açık tutun.

Bağlantıya hazırlanın

1. Hesap oluşturun ve hesabınızın API anahtarını sunucu tarafındaki yapılandırmanızda kullanın.
2. Sunmayı planladığınız hizmetlerin koşullarını ve hizmet kataloğunu okuyun. Gereklilikler, kullanılabilir seçenekler ve sipariş sınırları seçilen hizmete bağlıdır.
3. İstekleri kendi sunucunuzdan HTTPS üzerinden gönderin. Standart TLS sertifika doğrulamasını açık tutun.
4. API anahtarını sunucunuzda güvenli şekilde saklayın. Herkese açık sayfalara, tarayıcı JavaScript koduna, ekran görüntülerine veya paylaşılan kod örneklerine eklemeyin.

İlk salt okunur isteğinizi gönderin

Belgelenen uç nokta POST isteklerini kabul eder ve JSON döndürür. Resmi istek örneğinde URL kodlamalı form parametreleri kullanılır. Her işlem API anahtarınızı ve bir işlem adını içerir.

POST https://alwayscompleted.com/api/v2

key=YOUR_API_KEY&action=services

Yer tutucuyu yalnızca sunucu tarafındaki yapılandırmanızda değiştirin. services işlemi kataloğu okur; sipariş oluşturmaz. Sipariş formunuzu geliştirmeden önce hizmet kimliklerini belirlemek ve mevcut alanları incelemek için yanıtı kullanın.

Güncel hizmet ve hesap bilgilerini kullanın

Hizmet listesinde her hizmetin adı, türü, kategorisi, fiyatı, minimum ve maksimum miktarı ile telafi ve iptal göstergeleri yer alır. Seçilen hizmet kimliğini güncel açıklaması ve gereklilikleriyle eşleştirin. Sipariş hazırlarken belgedeki örnek kimlikleri veya fiyatları kopyalamak yerine döndürülen verileri kullanın.

Hesap bakiyenizi ve para birimini okumak için action=balance kullanın. Referanstaki tutarları örnek veri olarak değerlendirin. Uygulamanız gerçek yanıtı göstermeli ve devam etmeden önce hataları ele almalıdır.

Önbellekteki katalog değişikliklerini yönetin

Önbellekteki kataloğu yenilerken kaydedilmiş seçenekleri yeniden kullanıma açmadan önce kaldırılan hizmet kimliklerini ve değişen fiyat veya miktar sınırlarını kontrol edin. Seçilen kimlik güncel yanıtta yoksa benzer adlı bir hizmet seçmek yerine siparişi inceleme için duraklatın. Fiyat, tür veya miktar sınırı değişirse action=add göndermeden önce formunuzu güncelleyin ve seçimi yeniden doğrulayın. Sonraki soruların uygulamanızın gerçekten incelediği seçime kadar izlenebilmesi için kontrol edilen hizmet ayrıntılarını yerel sipariş kaydınızla birlikte saklayın.

Siparişleri bilinçli olarak oluşturun

Sipariş oluşturmak için seçilen hizmet kimliği ve o hizmet türünün gerektirdiği alanlarla action=add gönderin. Default türündeki siparişler link ve quantity kullanır; diğer türlerin parametreleri farklıdır. Göndermeden önce referansın ilgili bölümünü kontrol edin.

Oluşturma başarılı olduğunda döndürülen sipariş kimliğini kendi sipariş kaydınızla birlikte saklayın. İstek zaman aşımına uğrarsa veya yanıtı belirsizse yeniden göndermeden önce sonucu kontrol edin. Bir add isteğini kontrol etmeden tekrarlamak istemeden çift sipariş oluşturabilir. Sipariş oluşturmayı hiçbir zaman otomatik bağlantı testi olarak kullanmayın.

Siparişleri ve desteklenen takip taleplerini izleyin

Tek sipariş için order ile action=status, en fazla 100 siparişlik grup için ise virgülle ayrılmış kimlikleri içeren orders kullanın. Belgelenen yanıtta status, charge, start_count, remains ve currency bulunur. Her sonucu inceleyin: toplu yanıtta belirli bir kimlik için hata bulunabilir.

Telafi ve iptal; kullanılabilirliğe ve seçilen hizmetin koşullarına tabi taleplerdir. Telafi istemek için action=refill, durumunu takip etmek için action=refill_status ve iptal istemek için action=cancel kullanın. Belgelenen toplu sürümler en fazla 100 kimlik kabul eder. Talep göndermek, telafinin veya iptalin onaylanacağını garanti etmez.

Entegrasyonunuza devam edin

İşlem parametrelerinin ve örneklerin tamamı için tam API referansını kullanın. Müşterilere yönelik bir hizmet iş akışı geliştiriyorsanız bayiler için AlwaysCompleted rehberini inceleyin. Müşteri siparişlerini kabul etmeden önce her hizmetin açıklamasıyla birlikte Koşullar ve Politikaları okuyun.