Abonelikler Raporu

Aboneliklerinizi raporlayın

Bu API hizmeti, Zotlo üzerinden oluşturulan tüm abonelik kayıtlarını güvenli, performanslı ve ölçeklenebilir bir şekilde sorgulamanıza olanak tanıyan read-only bir raporlama servisidir.

Bu API hizmeti, platformdaki aktif, pasif veya iptal edilmiş abonelikleri; tarih aralığı, paket/ürün, ülke gibi çeşitli filtreler ile görüntülemenizi sağlar. Cursor tabanlı sayfalama yapısı sayesinde büyük hacimli abonelik verilerini hızlı ve stabil şekilde çekebilir; raporlama ve operasyon süreçlerinizi kolayca yönetebilirsiniz. İlgili servis GET metodu ile çalışır ve temel endpoint aşağıdaki gibidir:

GET https://api.zotlo.com/v1/reports/activity/subscription

Parametreler	Açıklama	Zorunlu mu?
limit	Döndürülecek maksimum kayıt sayısı. (Default: 25, max: 100)	Opsiyonel
country	İşlemin gerçekleştiği ülkeye göre filtreleme.	Opsiyonel
package_id	İşlemin bağlı olduğu paket/plan türüne göre filtreleme.	Opsiyonel
start_date	Belirtilen tarihten sonraki işlemleri listeler. (Y-m-d)	Opsiyonel
end_date	Belirtilen tarihten önceki işlemleri listeler. (Y-m-d)	Opsiyonel
before	Bir önceki sayfaya geçmek için, response içinde dönen before cursor değerinin tekrar gönderilmesi gerekir.	Yalnızca sayfalama aşamasında zorunlu.
after	Bir sonraki sayfaya geçmek için, response içinde dönen after cursor değerinin tekrar gönderilmesi gerekir.	Yalnızca sayfalama aşamasında zorunlu.

Örnek İstek:

Ödeme İşlemleri Raporu servisine istek gönderirken gerekli olan Access Key,Access Secret ve App Id bilgilerine, Zotlo Panel'de yer alan Developer Tools/API Keys sayfasından ulaşabilirsiniz. Bu bilgileri isteğin header'ında göndermeniz gerekmektedir.

GET https://api.zotlo.com/v1/reports/activity/subscription?limit=50?&start_date=2025-11-01&end_date=2025-11-30 HTTP/1.1
AccessKey: ••••••
AccessSecret: ••••••
Content-Type: application/json
ApplicationId: •
Language: ••

Başarılı Cevap Örneği

{
  "meta": {
    "requestId": "5896c0267514-REQ-6924662e5718a",
    "httpStatus": 200
  },
  "result": {
    "data": [
      {
        "id": 343,
        "platform": "ios",
        "startDate": "2025-11-10 08:27:37",
        "expireDate": "2025-11-10 08:28:08",
        "subscriberId": "3a33eb5d-3e4b-4875-916f-7e9fb5867f3f",
        "productId": "web_premium",
        "originalTransactionId": "29d557b4-2563-497b-ad1f-677ac6910b81",
        "lastTransactionId": "29d557b4-2563-497b-ad1f-677ac6910b81",
        "lastTrandactionDate": "2025-11-10 08:27:37",
        "status": "passive",
        "subscriptionType": "paid",
        "currency": "TRY",
        "price": "200.00",
        "trialPrice": "0.00",
        "country": "TR",
        "language": "TR",
        "teamId": 1,
        "providerId": 13,
        "period": 1,
        "trialPeriod": 0,
        "renewalDate": "2025-12-10 08:27:37",
        "appId": 1,
        "cancellationDate": "2025-11-10 08:28:08",
        "cancellationReason": "{\"reason\":\"\",\"user\":\"API: \"}",
        "cancellationCode": "CU00002",
        "mobilePhone": "[phone]",
        "email": "[email protected]",
        "jsonPayload": "{\"forceWebhook\":true,\"subscriberIpAddress\":\"0.0.0.0\"}",
        "quantity": 1,
        "pendingQuantity": 0,
        "periodType": "month",
        "trialPeriodType": "day",
        "packageCountry": "TR",
        "freezeEndDate": null
      },
      {
        "id": 342,
        "platform": "ios",
        "startDate": "2025-11-10 08:19:29",
        "expireDate": "2025-11-10 08:26:59",
        "subscriberId": "8aa4de92-a86d-4330-bb3c-6995a5f837ed",
        "productId": "web_premium",
        "originalTransactionId": "6edc57b0-86a1-4ba7-bf9a-81d05afbf505",
        "lastTransactionId": "6edc57b0-86a1-4ba7-bf9a-81d05afbf505",
        "lastTrandactionDate": "2025-11-10 08:19:29",
        "status": "passive",
        "subscriptionType": "paid",
        "currency": "TRY",
        "price": "200.00",
        "trialPrice": "0.00",
        "country": "TR",
        "language": "TR",
        "teamId": 1,
        "providerId": 13,
        "period": 1,
        "trialPeriod": 0,
        "renewalDate": "2025-12-10 08:19:29",
        "appId": 1,
        "cancellationDate": "2025-11-10 08:26:59",
        "cancellationReason": "{\"reason\":\"\",\"user\":\"API: \"}",
        "cancellationCode": "CU00002",
        "mobilePhone": "[phone]",
        "email": "[email protected]",
        "jsonPayload": "{\"forceWebhook\":true,\"subscriberIpAddress\":\"0.0.0.0\"}",
        "quantity": 1,
        "pendingQuantity": 0,
        "periodType": "month",
        "trialPeriodType": "day",
        "packageCountry": "TR",
        "freezeEndDate": null
      }
    ],
    "paging": {
      "cursors": {
        "previous": null,
        "next": "ExxyYaIVgzdwKWb7tuUf8WlwMlFSZmcxYVpiem5iWE93NW9EZkMrYk9oSE9tVEYrUlV4TUZMV2Y2ZG9VOEhucFdaSHRxNXVFaEdwYS90Z2lXRnpweEtzcG1WbG04THBLMGtJMWlmL2NKdjFneDJZZE5mNEIyVTNwQWlFSFV4ZU9wL2gyRUc0N2JYdjc0SEwxOVZwVGU4MUV3VUM2UFJCbWt0Y0tacUpjVFliRWg3eEoySVhWSEF2RDJIdkE2S3M4dCtiekZlMGJkZFFpblIxZU4vWE1hZmErTzJRSmdVNFBnbHFDQ28ya2hDMVJ5ZTJpU1ZyWGNLbGxrK009"
      },
      "previous": "https://local-api.zotlo.com:39443/v1/reports/activity/subscription",
      "next": "https://local-api.zotlo.com:39443/v1/reports/activity/subscription?after=ExxyYaIVgzdwKWb7tuUf8WlwMlFSZmcxYVpiem5iWE93NW9EZkMrYk9oSE9tVEYrUlV4TUZMV2Y2ZG9VOEhucFdaSHRxNXVFaEdwYS90Z2lXRnpweEtzcG1WbG04THBLMGtJMWlmL2NKdjFneDJZZE5mNEIyVTNwQWlFSFV4ZU9wL2gyRUc0N2JYdjc0SEwxOVZwVGU4MUV3VUM2UFJCbWt0Y0tacUpjVFliRWg3eEoySVhWSEF2RDJIdkE2S3M4dCtiekZlMGJkZFFpblIxZU4vWE1hZmErTzJRSmdVNFBnbHFDQ28ya2hDMVJ5ZTJpU1ZyWGNLbGxrK009"
    }
  }
}

Başarısız Cevap Örneği

Servislerimizden HTTP status code olarak başarılı durumlarda 200 dönmektedir. Başarısız durumlarda ise 400 ya da 500 Http StatusCode dönmektedir. Örnek hata cevabı aşağıdaki şekildedir.

{
  "meta": {
    "requestId": "5896c0267514-REQ-692464aa9a8c8",
    "httpStatus": 400,
    "errorMessage": "Invalid start_date format. Use Y-m-d",
    "errorCode": "400024"
  },
  "result": []
}

Başarısız Cevap Parametreleri:

Başarısız dönen isteklerde yer alan parametreler aşağıdaki gibidir. Başarısız isteklerde hata kodu olarak 400 ya da 500 dönmektedir.

requestId	Hatanın HTTP durum kodu değeriHer istek için sistem tarafından atanan id değeridir. Sistemsel hatalarda log'lardan hata yakalamak için kullanılır.
httpStatus	Hatanın HTTP durum kodu değeri
errorMessage	Hata mesajıdır. Tüm hata kodlarına buradan ulaşabilirsiniz.
errorCode	İlgili hata için Zotlo tarafından verilen hata kodu