Hızlı Başlangıç Rehberi
GetLinkDB, frontend (ön yüz) projeleriniz için anında kullanabileceğiniz, hiçbir kurulum gerektirmeyen bir veritabanı servisidir.
🔑 API Anahtarı (API Key) Nedir?
Sisteme kayıt olduğunuzda ve bir veritabanı oluşturduğunuzda size özel bir API Anahtarı verilir (Örn: gldb_12345...). Veritabanınıza erişmek için tüm isteklerinizde bu anahtarı göndermek zorundasınız.
Sisteme kayıt olduğunuzda ve bir veritabanı oluşturduğunuzda size özel bir API Anahtarı verilir (Örn: gldb_12345...). Veritabanınıza erişmek için tüm isteklerinizde bu anahtarı göndermek zorundasınız.
Kimlik doğrulama işlemi HTTP Başlıkları (Headers) üzerinden yapılır:
Authorization: Bearer YOUR_API_KEY_HEREContent-Type: application/jsonPOSThttps://getlinkdb.com/api/v1/insert
Veritabanınıza yeni bir kayıt eklemek için kullanılır. Veriler "collection" (tablo adı) ve "data" (içerik) olarak iki parça halinde gönderilmelidir.
JavaScript (Fetch API) ile Kullanımı:
Kullanıcı kayıt formu doldurduğunda verileri veritabanına kaydetmek için:
// Data payload to sendconst payload = { collection: "users", // Table name (e.g., users, messages, products)data: { name: "John Doe", age: 28, job: "Software Developer" } }; // Sending POST request to GetLinkDBfetch('https://getlinkdb.com/api/v1/insert', { method: 'POST', headers: { 'Authorization': 'Bearer gldb_your_secret_key_here', 'Content-Type': 'application/json' }, body: JSON.stringify(payload) }) .then(response => response.json()) .then(result => console.log("Success:", result)) .catch(error => console.error("Error:", error));Python (Requests) ile Kullanımı:
import requests url = "https://getlinkdb.com/api/v1/insert" headers = { "Authorization": "Bearer gldb_your_secret_key_here", "Content-Type": "application/json" } payload = { "collection": "blog_posts", "data": { "title": "Using API with Python", "views": 150 } } response = requests.post(url, json=payload, headers=headers) print(response.json())GEThttps://getlinkdb.com/api/v1/get?collection=TABLE_NAME
Daha önce kaydettiğiniz verileri sitenizde göstermek için geri çekmenizi sağlar. URL sonuna "collection=" ekleyerek sadece o tablodaki verileri filtreleyebilirsiniz.
JavaScript (Fetch API) ile Kullanımı:
"users" tablosundaki tüm kişileri listelemek için:
fetch('https://getlinkdb.com/api/v1/get?collection=users', { method: 'GET', headers: { 'Authorization': 'Bearer gldb_your_secret_key_here' } }) .then(response => response.json()) .then(data => { // Log the retrieved data console.log("Total Records:", data.count); console.log("Users:", data.data); });💡 İpucu: Eğer URL sonuna ?collection= eklemezseniz, veritabanınızdaki TÜM veriler (hangi tabloda olursa olsun) karışık olarak getirilir.
Hata Kodları (Durum Mesajları)
Sistemimiz olası bir sorunda size neyin yanlış gittiğini anlatan HTTP durum kodları döndürür.
| Kod | Anlamı ve Çözümü |
|---|---|
| 200 / 201 | Başarılı: İşleminiz sorunsuz gerçekleşti. |
| 400 | Eksik Veri: Gönderdiğiniz JSON formatı hatalı veya "collection", "data" alanları eksik. |
| 401 | Yetkisiz Giriş: API Anahtarınızı (Bearer Token) yanlış girdiniz veya hiç göndermediniz. |
| 429 | Limit Aşıldı: Aylık API istek limitinizi doldurdunuz. Kullanıma devam etmek için panelden paketinizi yükseltin. |
| 507 | Depolama Dolu: Mevcut paketinizin MB (Megabayt) depolama sınırına ulaştınız. Veri eklenemedi. |