Geliştirici & API Portalı

Genel Bakış

Geliştirme Aşamasında

Geliştirme Aşamasında: Kognis REST API v1 açık geliştirici erişimi ve Sandbox test ortamı şu anda aktif geliştirme aşamasındadır.

Kognis API; harici ERP, CRM, e-ticaret ve kurumsal sistemlerinizi Kognis bulut SaaS ekosistemine bağlamak üzere JSON tabanlı standart REST mimarisiyle tasarlanmaktadır.

BASE URL https://api.kognis.net/v1

Kimlik Doğrulama (Authentication)

Geliştirme Aşamasında

Geliştirme Aşamasında: API anahtarı (API Key) ve Bearer Token oluşturma paneli yönetim merkezinde geliştirilmektedir.

Tüm API isteklerinde HTTP başlığı (header) üzerinden kurumsal API anahtarınızın gönderilmesi gerekecektir.

Örnek İstek Başlığı

Authorization: Bearer kognis_live_sec_************************
X-API-Key: kognis_key_****************
Content-Type: application/json
Accept: application/json

Hata Yanıtları

Geliştirme Aşamasında

Geliştirme Aşamasında: Hata kodları standart HTTP durum kodları ile RFC 7807 uyumlu JSON formatında standardize edilmektedir.

API isteklerinizde oluşabilecek yetkilendirme, kota aşımı veya doğrulama hatalarında aşağıdaki formatta yanıt dönecektir:

{
  "success": false,
  "error": {
    "code": "UNDER_DEVELOPMENT",
    "message": "Bu API uç noktası şu anda geliştirme aşamasındadır.",
    "status": 503
  }
}

WhatsApp Mesaj Gönderimi

Geliştirme Aşamasında

Geliştirme Aşamasında: WhatsApp Cloud API mesajlaşma ve bildirim kuyruğu entegrasyonu geliştirilmektedir.

POST /v1/whatsapp/messages/send

Örnek İstek Gövdesi (Request Body)

{
  "phone": "+905320000000",
  "template": "order_confirmation",
  "parameters": {
    "customer_name": "John Doe",
    "order_id": "KG-2026-88"
  }
}

Abonelik & Lisans Doğrulama

Geliştirme Aşamasında

Geliştirme Aşamasında: Kiracı (Tenant) ve ürün bazlı lisans doğrulama protokolü geliştirilmektedir.

GET /v1/subscriptions/verify?domain=company.kognis.net

Örnek Yanıt (Response)

{
  "status": "in_development",
  "message": "Lisans sorgulama servisi aktif geliştirme aşamasındadır.",
  "valid": true,
  "expires_at": null
}