Partner API

Kayıp Patiler Pool

Diğer kayıp hayvan sitelerinin kendi ilanlarını Kayıp Patiler sistemine güvenli şekilde gönderebilmesi için hazırlanmış entegrasyon katmanı.

Nasıl çalışır?

Her partner siteye özel bir apiKey tanımlanır. İstekler bu anahtar ile doğrulanır ve ilanlar ilgili partner hesabına bağlanır.

İlan akışı

Yeni eklenen ilanlar onay bekleyen olarak sisteme düşer. Böylece moderasyon sonrası yayına alınabilir.

Görsel desteği

Partner tarafı görsel URL’lerini yollar, sistem bu görselleri indirip kendi sunucusuna kaydeder.

Kimlik Doğrulama

Tüm partner isteklerinde aşağıdaki yöntemlerden biri ile apiKey gönderilebilir:

Demo Customer: id: 5 apiKey: demoKey

`GET /api/pool.php?page=ping`

GET Sağlık kontrolü

Ne işe yarar?

Pool servisinin ayakta olup olmadığını kontrol eder. Entegrasyona başlamadan önce ilk çağrılacak endpoint budur.

Gönderilecek İstek

GET /api/pool.php?page=ping | Header: apiKey: demoKey

curl

curl -X GET "/api/pool.php?page=ping" -H "apiKey: demoKey"

Örnek Response

{
  "success": true,
  "message": "",
  "code": 200,
  "countOfItem": 1,
  "data": {
    "health": {
      "ok": true,
      "serverTime": "2026-07-10 12:34:56"
    }
  }
}
Canlı response burada görünecek.

`GET /api/pool.php?page=getMainCategories`

GET Ana kategorileri getirir

Ne işe yarar?

Partner tarafında kategori seçim ekranını doldurmak için ana kategori listesini döner.

Gönderilecek İstek

GET /api/pool.php?page=getMainCategories | Header: apiKey: demoKey

curl

curl -X GET "/api/pool.php?page=getMainCategories" -H "apiKey: demoKey"

Örnek Response

{
  "success": true,
  "message": "",
  "code": 200,
  "countOfItem": 2,
  "data": {
    "mainCategoriesList": [
      { "id": "1", "categoryId": "1", "categoryName": "Kayıp", "categoryDesc": "" },
      { "id": "2", "categoryId": "2", "categoryName": "Sahiplendirme", "categoryDesc": "" }
    ]
  }
}
Canlı response burada görünecek.

`GET /api/pool.php?page=getTypes`

GET Hayvan türlerini getirir

Ne işe yarar?

Kedi, köpek gibi ana hayvan türlerini verir. Formlarda ilk dropdown için kullanılır.

Gönderilecek İstek

GET /api/pool.php?page=getTypes | Header: apiKey: demoKey

curl

curl -X GET "/api/pool.php?page=getTypes" -H "apiKey: demoKey"

Örnek Response

{
  "success": true,
  "message": "",
  "code": 200,
  "countOfItem": 2,
  "data": {
    "animalList": [
      { "id": "1", "catName": "Kedi" },
      { "id": "2", "catName": "Köpek" }
    ]
  }
}
Canlı response burada görünecek.

`GET /api/pool.php?page=getTypeById&typeId=1`

GET Alt türleri getirir

Ne işe yarar?

Seçilen ana türe bağlı alt türleri döner. Örneğin kedi için Tekir, British, Van gibi alt kırılımlar.

Gönderilecek İstek

GET /api/pool.php?page=getTypeById&typeId=1 | Header: apiKey: demoKey

curl

curl -X GET "/api/pool.php?page=getTypeById&typeId=1" -H "apiKey: demoKey"

Örnek Response

{
  "success": true,
  "message": "",
  "code": 200,
  "countOfItem": 2,
  "data": {
    "animalList": [
      { "id": "3", "catName": "Tekir", "catImg": "..." },
      { "id": "4", "catName": "British Shorthair", "catImg": "..." }
    ]
  }
}
Canlı response burada görünecek.

`POST /api/pool.php?page=addPost`

POST Yeni ilan ekler

Ne işe yarar?

Partner sitenizdeki ilanı pool sistemine yollar. İlan onay bekleyen olarak kaydolur ve moderasyon sonrası yayına alınır.

curl

curl -X POST "/api/pool.php?page=addPost" -H "apiKey: demoKey" -d "animalType=1" -d "animalSubType=3" -d "postCategory=1" -d "postTitle=Demo Pool İlanı" -d "postDescription=Pool docs üzerinden gönderilen örnek ilan." -d "postLat=41.015137" -d "postLong=28.979530" -d "cityName=İstanbul" -d "district=Kadıköy" -d "neighbourhood=Moda" -d "hasPrize=0" -d "prizeCount=0" -d "extLink=https://example.org/demo-ilan/123" -d 'imagesString=["https://placehold.co/800x600/png","https://placehold.co/640x480/jpg"]'

Örnek Response

{
  "success": true,
  "message": "",
  "code": 200,
  "countOfItem": 1,
  "data": {
    "postDetail": {
      "postId": 1452,
      "status": 2,
      "message": "İşleminiz başarıyla gerçekleşti, ilanınız onay sonrası yayına alınacaktır.",
      "imageCount": 2
    }
  }
}
Canlı response burada görünecek.

`GET /api/pool.php?page=myPosts`

GET Partner sitenin ilanlarını getirir

Ne işe yarar?

Gönderilen apiKey’e bağlı partner müşterinin tüm ilanlarını listeler.

Gönderilecek İstek

GET /api/pool.php?page=myPosts | Header: apiKey: demoKey

curl

curl -X GET "/api/pool.php?page=myPosts" -H "apiKey: demoKey"

Örnek Response

{
  "success": true,
  "message": "",
  "code": 200,
  "countOfItem": 1,
  "data": {
    "postList": [
      {
        "id": "1452",
        "postTitle": "Demo Pool İlanı",
        "cityName": "İstanbul",
        "district": "Kadıköy",
        "isActive": "2",
        "customerId": "5"
      }
    ]
  }
}
Canlı response burada görünecek.

`POST /api/pool.php?page=updatePostStatus`

POST İlan durumunu günceller

Ne işe yarar?

Partner sitenin kendi ilanını reddedildi, onay bekliyor veya bulundu gibi statülere çekmesini sağlar. 1 yani doğrudan onaylama yetkisi verilmez.

curl

curl -X POST "/api/pool.php?page=updatePostStatus" -H "apiKey: demoKey" -d "postId=1452" -d "status=3"

Örnek Response

{
  "success": true,
  "message": "",
  "code": 200,
  "countOfItem": 1,
  "data": {
    "postDetail": {
      "id": "1452",
      "postTitle": "Demo Pool İlanı",
      "isActive": "3"
    }
  }
}
Canlı response burada görünecek.

İletişim

Pool entegrasyonu, partner kaydı, apiKey tanımlama veya iş birliği için emir@beytekin.net adresine e-posta atın.