Developer Documentation

PENGONA DOCS

API dokümantasyonu, entegrasyon kılavuzları ve geliştirici kaynakları. Pengona ürünlerini projelerinize entegre etmek için ihtiyacınız olan her şey burada.

API Reference

Detaylı API dokümantasyonu

Guides

Adım adım entegrasyon kılavuzları

Quick Start

Hızlı başlangıç örnekleri

Dokümantasyon

Hızlı Erişim

Status Page Changelog Support GitHub

Docs/API Reference/Cloud Portal API

Cloud Portal API Entegrasyonu

Pengona Cloud Portal API'sini kullanarak tedarik süreçlerinizi otomatikleştirin. Bu dokümantasyon, API'yi projelerinize entegre etmek için gereken tüm bilgileri içerir.

Başlamadan Önce

API'yi kullanmaya başlamak için öncelikle Pengona Cloud Portal hesabınızdan API anahtarınızı almanız gerekir. Hesabınız yoksa buradan kayıt olabilirsiniz.

1. Kimlik Doğrulama

Pengona Cloud Portal API, Bearer token tabanlı kimlik doğrulama kullanır. API anahtarınızı her istekte Authorization header'ında göndermeniz gerekir.

API Anahtarı Kullanımı

curl -H "Authorization: Bearer YOUR_API_KEY"
"https://api.pengona.com/v1/suppliers"

Güvenlik Uyarısı

API anahtarınızı asla client-side kodda veya public repository'lerde paylaşmayın. Sunucu tarafında environment variable olarak saklayın.

2. Base URL ve Endpoints

Tüm API istekleri aşağıdaki base URL üzerinden yapılır. API versiyonu URL'de belirtilir.

Production

https://api.pengona.com/v1

Sandbox

https://sandbox-api.pengona.com/v1

Ana Endpoints

Tedarikçiler/suppliers

Ürünler/products

Siparişler/orders

Faturalar/invoices

HTTP Metodları

GETVeri okuma

POSTYeni veri oluşturma

PUTVeri güncelleme

DELETEVeri silme

3. Örnek API İsteği

Aşağıda tedarikçi listesini almak için örnek bir API isteği bulunmaktadır. Bu örneği kendi uygulamanızda kullanabilirsiniz.

Tedarikçi Listesi

GET

GET https://api.pengona.com/v1/suppliers
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Yanıt Örneği

{
  "data": [
    {
      "id": "sup_123456",
      "name": "ABC Tedarik Ltd.",
      "email": "info@abctedarik.com",
      "phone": "+90 850 807 6060",
      "status": "active",
      "created_at": "2024-01-15T10:30:00Z"
    }
  ],
  "meta": {
    "total": 1,
    "page": 1,
    "per_page": 20
  }
}

4. HTTP Durum Kodları

API, standart HTTP durum kodlarını kullanır. Aşağıda en yaygın durum kodları ve anlamları yer almaktadır.

Başarılı Yanıtlar

200OK - İstek başarılı

201Created - Kaynak oluşturuldu

204No Content - Başarılı, içerik yok

Hata Yanıtları

400Bad Request - Geçersiz istek

401Unauthorized - Kimlik doğrulama hatası

404Not Found - Kaynak bulunamadı

500Server Error - Sunucu hatası

5. Rate Limiting

API kullanımında adil kullanım politikası uygulanır. Aşağıdaki limitler geçerlidir:

1000

İstek/Saat

Starter Plan

5000

İstek/Saat

Professional Plan

∞

Sınırsız

Enterprise Plan

Sonraki Adımlar

API'yi kullanmaya başlamak için aşağıdaki adımları takip edebilirsiniz:

SDK'larımızı indirin

Sandbox ortamında test edin

Webhook'ları yapılandırın

Production'a geçin

Monitoring kurun

Destek ekibiyle iletişime geçin

Yardıma mı İhtiyacınız Var?

Dokümantasyonda bulamadığınız bir şey mi var? Uzman ekibimiz size yardımcı olmaya hazır.

Developer Support

Teknik sorularınız için 7/24 teknik ekip desteği

Tutorials

Adım adım video eğitimler, ve örnekleri incele

Code Examples

GitHub'da hazır kod örnekleri ve starter kit'ler

Developer Community

Pengona developer topluluğuna katılın. Diğer geliştiricilerle deneyim paylaşın, sorularınızı sorun ve en son güncellemelerden haberdar olun.

5000+

Aktif Developer

1000+

API Entegrasyonu

24/7

Community Support

99.9%

API Uptime