Tüm sistemler çalışıyor Giriş Yap →
bilgi-arşivi/ API & Entegrasyon/ API Nedir?
API & Entegrasyon

API Nedir?

Yayınlandı: 13 Ağu 2026 · Güncellendi: 13 Ağu 2026 · 9 dk okuma
OOpenAIAraştırmacı

API (Application Programming Interface), farklı yazılımların birbiriyle iletişim kurmasını sağlayan bir arayüzdür. Basitçe ifade etmek gerekirse API, bir yazılımın başka bir yazılıma belirli işlemleri otomatik olarak yaptırmasına veya sistemden bilgi almasına olanak sağlar.

RoketBayim API sayesinde kendi web siteniz, SMM paneliniz, botunuz veya farklı bir yazılımınız üzerinden RoketBayim hesabınızla otomatik olarak iletişim kurabilirsiniz. Böylece panel üzerinden manuel olarak yaptığınız birçok işlemi kendi yazılımınız içerisinde otomatikleştirebilirsiniz.

Örneğin kendi SMM paneliniz varsa, müşteriniz panelinizden bir sipariş oluşturduğunda siparişi manuel olarak RoketBayim'e girmeniz gerekmez. Kendi yazılımınız, API aracılığıyla siparişi otomatik olarak RoketBayim'e gönderebilir. Daha sonra siparişin durumunu yine API üzerinden kontrol ederek müşterinize gösterebilirsiniz.

RoketBayim API adresi: https://roketbayim.com/api/v2. API isteklerinizi bu adres üzerinden gerçekleştirebilirsiniz.

API neden kullanılır?

API'nin temel amacı, farklı sistemler arasında otomatik ve programatik iletişim sağlamaktır. Bir kullanıcı panelinizde işlem yaptığında bu işlemi başka bir sisteme manuel olarak aktarmak yerine API kullanarak otomatik şekilde iletebilirsiniz.

Örneğin bir SMM panelinin RoketBayim'e bağlı olduğunu düşünelim. Müşteriniz panelinizde 1.000 takipçi siparişi verdiğinde aşağıdaki işlemler otomatik olarak gerçekleşebilir:

1
Müşteri sipariş verir. Müşteriniz kendi paneliniz üzerinden servis, bağlantı ve miktar bilgisini girer.
2
Sisteminiz API isteği oluşturur. Kendi yazılımınız gerekli bilgileri RoketBayim API'sine gönderir.
3
RoketBayim siparişi oluşturur. Gönderilen bilgiler kontrol edilir ve uygunsa yeni bir sipariş oluşturulur.
4
Sipariş ID'si döndürülür. Başarılı bir siparişte API, oluşturulan siparişin ID'sini yazılımınıza gönderir.
5
Sipariş takip edilir. Yazılımınız sipariş durumunu API üzerinden sorgulayarak kendi panelinizde güncel durumu gösterebilir.

RoketBayim API nasıl çalışır?

API ile iletişim kurarken temel olarak iki taraf bulunur: API isteğini gönderen istemci ve isteği işleyen RoketBayim API'si.

Sizin yazılımınız bir işlem yapmak istediğinde RoketBayim API'sine bir request (istek) gönderir. Bu istekte API anahtarınız, gerçekleştirmek istediğiniz işlem ve işlemin gerektirdiği diğer parametreler bulunur.

RoketBayim API isteği işledikten sonra sonucunu bir response (yanıt) olarak yazılımınıza gönderir. Bu yanıt başarılı bir işlemi veya oluşan hatayı içerebilir.

Request nedir?

Request, sizin API'ye gönderdiğiniz istektir. Örneğin servis listesini almak istediğinizde API'ye hangi hesabın işlem yaptığını ve hangi işlemi istediğinizi belirtmeniz gerekir.

RoketBayim API'de temel olarak key ve action gibi parametreler kullanılır. Gerçekleştirilecek işleme göre service, link, quantity, order veya başka parametreler de gönderilebilir.

Response nedir?

Response, API'nin gönderdiğiniz isteğe verdiği yanıttır. Başarılı bir sipariş oluşturduğunuzda örneğin aşağıdaki gibi bir response alabilirsiniz:

{
  "order": 23501
}

Buradaki 23501 değeri oluşturulan siparişin ID'sidir. Kendi sisteminiz bu ID'yi kaydederek daha sonra siparişin durumunu sorgulayabilir.

Endpoint nedir?

Endpoint, API'ye istek gönderdiğiniz adresi ifade eder. RoketBayim API'de işlemler aynı API endpoint'i üzerinden action parametresi kullanılarak belirlenir.

https://roketbayim.com/api/v2

Örneğin action=services gönderildiğinde servis listesi istenirken, action=balance gönderildiğinde bakiye sorgulanır.

RoketBayim API ile neler yapılabilir?

RoketBayim API, bayi entegrasyonları için gerekli temel işlemleri destekler. API üzerinden servislerinizi sorgulayabilir, sipariş oluşturabilir, siparişlerin durumunu kontrol edebilir, refill işlemleri gerçekleştirebilir, siparişleri iptal edebilir ve hesabınızın bakiyesini sorgulayabilirsiniz.

  • Servis listesini görüntüleme
  • Tekli sipariş oluşturma
  • Toplu sipariş oluşturma
  • Tekli sipariş durumu sorgulama
  • Toplu sipariş durumu sorgulama
  • Refill oluşturma
  • Toplu refill oluşturma
  • Refill durumunu sorgulama
  • Sipariş iptali
  • Bakiye sorgulama

API anahtarı nedir?

API Key, yazılımınızın RoketBayim hesabınız adına API üzerinden işlem yapabilmesini sağlayan özel anahtardır. API'ye gönderdiğiniz isteklerde hesabınızı tanımlamak için kullanılır.

API anahtarınız hesabınıza özel olduğu için gizli tutulmalıdır. API anahtarınızı bilen bir kişi, yetkileri dahilinde hesabınız adına API üzerinden işlem gerçekleştirebilir.

✕
API anahtarınızı paylaşmayın. API Key'inizi müşterilerinize, frontend JavaScript kodlarına, herkese açık GitHub depolarına veya güvenmediğiniz üçüncü taraflara eklemeyin.

GET ve POST nedir?

RoketBayim API, dokümantasyonda belirtilen işlemler için GET ve POST isteklerini destekler. Her iki yöntemde de API'ye gerekli parametreleri göndererek işlem gerçekleştirebilirsiniz.

GET isteği

GET isteklerinde parametreler URL içerisinde gönderilir. Örneğin tek bir siparişin durumunu sorgulamak için aşağıdaki yapıyı kullanabilirsiniz:

https://roketbayim.com/api/v2?key=your_api_key&action=status&order=12345

POST isteği

POST isteklerinde parametreler isteğin gövdesinde gönderilir. Entegrasyonlarda POST kullanmak, özellikle daha fazla veri içeren işlemlerde daha uygun olabilir.

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

key=your_api_key
action=status
order=12345

Toplu sipariş gibi JSON veri yapısının kullanıldığı işlemlerde POST isteği kullanılması gerekir.

Servis listesi API'si nasıl çalışır?

action=services kullanarak hesabınız üzerinden kullanılabilir servislerin listesini alabilirsiniz.

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

key=your_api_key
action=services

Başarılı response içerisinde servis ID'si, servis adı, servis tipi, kategori, fiyat, minimum ve maksimum miktar ile refill ve cancel desteği gibi bilgiler bulunabilir.

[
  {
    "service": 1,
    "name": "Instagram Takipçi",
    "type": "Default",
    "category": "Instagram",
    "rate": "12.50",
    "min": 100,
    "max": 10000,
    "refill": true,
    "cancel": true
  }
]

Servis bilgilerindeki alanlar ne anlama gelir?

  • service: Servisin benzersiz ID'sidir.
  • name: Servisin adıdır.
  • type: Servisin sipariş tipidir.
  • category: Servisin ait olduğu kategoridir.
  • rate: Servisin fiyat bilgisidir.
  • min: Verilebilecek minimum sipariş miktarıdır.
  • max: Verilebilecek maksimum sipariş miktarıdır.
  • refill: Servisin refill destekleyip desteklemediğini belirtir.
  • cancel: Servisin iptal desteğini belirtir.

Sipariş oluşturma nasıl çalışır?

action=add kullanarak tek bir sipariş oluşturabilirsiniz. Normal servislerde temel olarak servis ID'si, bağlantı ve miktar gönderilir.

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

key=your_api_key
action=add
service=1
link=https://instagram.com/example
quantity=1000

Sipariş başarıyla oluşturulduğunda API size sipariş ID'sini döndürür:

{
  "order": 23501
}

Bu ID'yi kendi sisteminizde kaydetmeniz önemlidir. Siparişin durumunu kontrol etmek, refill oluşturmak veya uygun olduğunda iptal işlemi gerçekleştirmek için bu ID'ye ihtiyaç duyabilirsiniz.

Custom Comments servisleri

Servis listesindeki type alanı Custom Comments olan servisler normal servislerden farklıdır. Bu servislerde quantity yerine comments parametresi gönderilir.

Yorumlar satır satır gönderilir. Sistem, gönderilen yorum satırlarının sayısından miktarı otomatik olarak hesaplar.

key=your_api_key
action=add
service=2
link=https://instagram.com/example
comments=Yorum 1
Yorum 2
Yorum 3

Toplu sipariş nedir?

Birden fazla siparişi ayrı ayrı API isteği göndermek yerine Bulk Add Order özelliğini kullanarak tek bir istek içerisinde gönderebilirsiniz.

Toplu sipariş işleminde tek istekte en fazla 100 sipariş gönderilebilir.

POST https://roketbayim.com/api/v2
Content-Type: application/json

{
  "key": "your_api_key",
  "action": "add_bulk",
  "orders": [
    {
      "service": 1,
      "link": "https://instagram.com/test1",
      "quantity": 100
    },
    {
      "service": 2,
      "link": "https://instagram.com/test2",
      "quantity": 200
    }
  ]
}
Toplu sipariş işlemi atomik değildir. Yani listedeki tüm siparişlerin başarılı olması garanti edilmez. Bazı siparişler başarılı olurken bazıları hata verebilir. Her sipariş için ayrı sonuç döndürülür.

Sipariş durumu nasıl kontrol edilir?

Bir sipariş oluşturduktan sonra action=status kullanarak siparişin güncel durumunu sorgulayabilirsiniz.

GET https://roketbayim.com/api/v2?key=your_api_key&action=status&order=23501

Başarılı bir response içerisinde ücret, başlangıç sayısı, sipariş durumu, kalan miktar ve para birimi gibi bilgiler bulunabilir.

{
  "charge": "0.27819",
  "start_count": "3572",
  "status": "Partial",
  "remains": "157",
  "currency": "TRY"
}

Birden fazla siparişin durumunu sorgulama

Birden fazla siparişi tek tek sorgulamak yerine orders parametresi ile birden fazla order ID'sini virgülle ayırarak gönderebilirsiniz. Bu yöntemde en fazla 100 sipariş ID'si sorgulanabilir.

GET https://roketbayim.com/api/v2?key=your_api_key&action=status&orders=23501,23502,23503

Sipariş durumları

Pending

Sipariş henüz işleme alınmayı bekliyor.

Processing

Sipariş işleniyor ve teslimat süreci devam ediyor.

Completed

Sipariş tamamlandı.

Partial

Sipariş kısmen tamamlandı ve kalan miktar teslim edilmedi.

Cancelled

Sipariş iptal edildi.

Refill nedir?

Refill, uygun servislerde tamamlanmış veya kısmen tamamlanmış siparişler için telafi talebi oluşturmanızı sağlar.

RoketBayim API üzerinden refill oluşturabilmek için siparişin durumunun Completed veya Partial olması gerekir. Ayrıca ilgili servisin refill desteğinin bulunması gerekir.

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

key=your_api_key
action=refill
order=23501

Başarılı bir refill işleminde refill ID'si ve durum bilgisi döndürülür:

{
  "refill": "23",
  "status": "completed"
}

Uygun olmayan bir sipariş, bulunamayan bir sipariş veya refill desteklemeyen bir servis için işlem rejected olarak sonuçlanabilir.

Birden fazla refill oluşturabilir miyim?

Evet. Birden fazla sipariş için aynı anda refill talebi oluşturabilirsiniz. Bunun için orders parametresine sipariş ID'lerini virgülle ayırarak göndermeniz gerekir.

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

key=your_api_key
action=refill
orders=12345,12346,12347

Toplu refill işleminde her sipariş için ayrı bir sonuç döndürülür. Bu nedenle response içerisindeki her sonucu ayrı ayrı kontrol etmeniz gerekir.

Refill durumu nasıl sorgulanır?

Oluşturduğunuz refill işlemlerinin durumunu action=refill_status ile sorgulayabilirsiniz.

Tek bir refill için:

GET https://roketbayim.com/api/v2?key=your_api_key&action=refill_status&refill=23

Birden fazla refill için:

GET https://roketbayim.com/api/v2?key=your_api_key&action=refill_status&refills=23,24,25
completed

Refill işlemi tamamlandı.

pending

Refill işlemi henüz tamamlanmadı.

rejected

Refill talebi reddedildi.

Sipariş iptali nasıl yapılır?

Uygun siparişleri API üzerinden iptal etmek için action=cancel kullanabilirsiniz.

Birden fazla sipariş ID'sini virgülle ayırarak aynı istekte gönderebilirsiniz.

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

key=your_api_key
action=cancel
orders=12345,12346,12347

Cancel response'unda her sipariş için ayrı sonuç döndürülebilir. Bu nedenle yalnızca HTTP isteğinin başarılı olmasına değil, response içerisindeki her siparişin sonucuna da bakmanız gerekir.

Bakiye nasıl sorgulanır?

Hesabınızın API bakiyesini öğrenmek için action=balance kullanabilirsiniz.

GET https://roketbayim.com/api/v2?key=your_api_key&action=balance

Başarılı response örneği:

{
  "balance": "100.84",
  "currency": "USD"
}

Bu bilgiyi kendi panelinizde bakiye kontrolü yapmak, sipariş göndermeden önce yeterli bakiyenin bulunup bulunmadığını kontrol etmek veya otomasyon sisteminizde karar vermek için kullanabilirsiniz.

Kendi SMM panelimi RoketBayim'e nasıl bağlayabilirim?

RoketBayim API'nin en yaygın kullanım amaçlarından biri kendi SMM paneliniz ile RoketBayim arasında otomatik bağlantı kurmaktır.

Temel entegrasyonda kendi panelinizdeki servisleri RoketBayim servisleriyle eşleştirmeniz ve müşterinizden gelen siparişleri API üzerinden RoketBayim'e göndermeniz gerekir.

1
Servisleri alın. API üzerinden servis listesini çekerek servis ID'lerini ve diğer servis bilgilerini alın.
2
Servisleri eşleştirin. Kendi panelinizdeki servisleri RoketBayim'deki servis ID'leriyle eşleştirin.
3
Siparişi gönderin. Müşteriniz sipariş verdiğinde kendi sunucunuz üzerinden RoketBayim API'sine sipariş gönderin.
4
Order ID'yi kaydedin. RoketBayim'den dönen order ID'yi kendi veritabanınızda saklayın.
5
Durumu senkronize edin. Order ID üzerinden sipariş durumunu belirli aralıklarla kontrol ederek kendi panelinizde güncelleyin.

API entegrasyonunda en önemli noktalar

API entegrasyonunuzun sorunsuz çalışması için yalnızca istek göndermek yeterli değildir. Dönen response'ları doğru şekilde işlemek de önemlidir.

  • Her sipariş için dönen order ID değerini kaydedin.
  • API response'larını kontrol etmeden siparişi başarılı kabul etmeyin.
  • Bulk işlemlerde her siparişin sonucunu ayrı ayrı kontrol edin.
  • Servislerin minimum ve maksimum miktarlarını kontrol edin.
  • Refill veya cancel işlemi göndermeden önce servisin ilgili özelliği desteklediğini kontrol edin.
  • API anahtarınızı yalnızca güvenli sunucu tarafında saklayın.
  • API hatalarını loglayarak entegrasyon sorunlarını daha kolay tespit edin.

API hatalarını nasıl yönetmeliyim?

API entegrasyonlarında yalnızca başarılı response'ları işlemek yeterli değildir. API tarafından döndürülen error alanlarını da kontrol etmelisiniz.

Örneğin geçersiz bir servis ID'si gönderildiğinde veya sipariş miktarı servis limitlerinin dışında olduğunda hata dönebilir.

{
  "error": "Service not found"
}

Benzer şekilde yeterli bakiyeniz bulunmadığında API bunu response içerisinde bildirebilir:

{
  "error": "Insufficient balance. Required: 15.500000, Available: 10.000000"
}
!
Dikkat. API isteğinin sunucuya ulaşması, işlemin mutlaka başarılı olduğu anlamına gelmez. Yazılımınız her zaman API response içeriğini kontrol etmelidir.

API anahtarımı frontend'de kullanabilir miyim?

API anahtarınızı doğrudan frontend JavaScript kodunuza koymanız önerilmez. Tarayıcıya gönderilen JavaScript kodu kullanıcı tarafından görüntülenebilir ve API anahtarınız üçüncü kişiler tarafından ele geçirilebilir.

En güvenli yöntem, API isteklerini kendi sunucunuz üzerinden gerçekleştirmektir. Kullanıcı tarayıcınızdan sizin sunucunuza istek gönderir, sunucunuz ise RoketBayim API'sine gerekli API anahtarıyla isteği iletir.

API entegrasyonuna nereden başlamalıyım?

API konusunda yeniyseniz tüm endpointleri aynı anda uygulamanız gerekmez. Öncelikle temel API akışını anlamanız ve küçük bir test entegrasyonu oluşturmanız önerilir.

1
API anahtarınızı hazırlayın. Entegrasyonunuzda kullanacağınız API Key'i hazır bulundurun.
2
Servis listesini çekin. Öncelikle API bağlantınızın çalıştığını services işlemiyle test edin.
3
Test siparişi oluşturun. Uygun bir servisle küçük bir test siparişi gönderin.
4
Sipariş durumunu sorgulayın. Aldığınız order ID ile status işlemini test edin.
5
Otomasyonu geliştirin. Temel akış çalıştıktan sonra bulk order, refill, cancel ve diğer işlemleri sisteminize ekleyin.

RoketBayim API dokümantasyonu

API'nin tüm işlemleri, parametreleri, response örnekleri ve farklı programlama dilleri için örnek kodları RoketBayim API & Entegrasyon dokümantasyonu üzerinden inceleyebilirsiniz.

API'ye yeni başlayan kullanıcılar için önerilen sıra Servis Listesi → Sipariş Oluşturma → Sipariş Durumu → Refill → Cancel → Bulk işlemler şeklindedir. Bu temel akışı öğrendikten sonra kendi SMM paneliniz veya otomasyon sisteminiz için daha gelişmiş bir entegrasyon oluşturabilirsiniz.