Dolaşıyo API

Temel adres https://dolasiyo.com/api/v1. Tüm yanıtlar JSON'dur: başarıda { "data": … }, hatada { "error": { code, message, details, requestId } }. Tutarlar istenen para biriminde (TRY, EUR, USD) tam sayı olarak döner; tahminler alt–üst aralıkla verilir.

Her yanıtta API-Version, X-Request-Id ve RateLimit-* başlıkları bulunur. Destek isterken X-Request-Id değerini paylaş.

1. Aşağıdan ücretsiz bir API anahtarı oluştur (doğrulanmış hesap gerekir).
2. Anahtarı ortam değişkeni olarak sakla: export DOLASIYO_API_KEY=dlsy_…. Tarayıcıda ya da herkese açık depoda paylaşma.
3. İlk isteğini at:

curl -X POST "https://dolasiyo.com/api/v1/plans" \
  -H "Authorization: Bearer $DOLASIYO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "input": { "origin": { "name": "Ankara", "lat": 39.9334, "lon": 32.8597, "country": "TR" }, "destination": { "name": "Göreme", "lat": 38.6431, "lon": 34.8289, "country": "TR" }, "nights": 3, "travelers": 2, "tier": "mid", "transport": "car", "roundTrip": true, "currency": "TRY" }, "save": false }'

Anahtarlar dlsy_ ile başlar ve sadece oluşturulduğu anda gösterilir. Biz yalnızca özetini (SHA-256) saklarız. Sızdığını düşündüğün anahtarı iptal edip yenisini oluştur.

Anahtarı iki biçimde gönderebilirsin:

Authorization: Bearer dlsy_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Anahtar bir istemciyi tanımlar, bir kullanıcı oturumu açmaz. Kişisel veriye dokunan uç noktalar (kaydetme, profil, e-posta) yalnızca web sitesindeki oturumla çalışır. Geçersiz ya da iptal edilmiş anahtar 401 unauthorized döner.

Sınırlar kayan pencereyle uygulanır. Anahtarlı istekler aşağıdaki değerlerin 5 katını alır ve günlük kotaya tabidir (varsayılan 5.000). Anahtarsız, sitemiz dışından gelen istekler IP başına günde 500 ile sınırlıdır.

Yanıt başlıkları: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset (saniye), anahtarla ayrıca X-Quota-Limit ve X-Quota-Remaining. Sınır aşılırsa 429 ve Retry-After döner; o süre kadar bekleyip üstel geri çekilmeyle (exponential backoff) tekrar dene.

Listeler imleçle sayfalanır: yanıttaki nextCursor değerini bir sonraki istekte cursor olarak gönder; null gelince liste bitmiştir. İmleçlerin içeriğine güvenme, opak kabul et.

Sürüm adreste yer alır (/api/v1). Geriye uyumsuz değişiklikler yeni sürümle gelir. Kaldırılacak uç noktalar en az 6 ay önce Deprecation ve Sunset başlıklarıyla duyurulur.

Bunlar web sitesinin kendisi içindir; tarayıcı oturumu (çerez) ve aynı kaynak (Origin) ister, API anahtarıyla çalışmaz.

• GET/me/plansKullanıcının planları
• GET/community-plans/{slug}Topluluk planı: yol, maliyet ve yazarın notları
• GET/auth-configHangi giriş yöntemleri açık (kodla giriş, şifre sıfırlama, `social`: Apple / Google ve Google istemci kimlikleri)
• GET/POST/me/adventuresSerüvenleri listele / plandan serüven başlat (`checklist` ile plan sayfasındaki işaretler taşınır)
• GET/PATCH/DELETE/me/adventures/{id}Serüven: adım işaretle, başlat, bitir, sil
• POST/me/adventures/{id}/memoriesSerüvene anı ekle (`{ text?, place?, day?, mood?, photoIds? }`; metin ya da en az bir fotoğraf)
• PATCH/DELETE/me/adventures/{id}/memories/{memoryId}Anıyı düzenle (`photoIds` sıralı listenin tamamı; çıkarılan fotoğraflar silinir) / anıyı fotoğrafları ve paylaşımıyla sil
• POST/me/adventures/{id}/memories/photosAnı fotoğrafı yükle: istek başına tek dosya (multipart `file` ya da ham image/*, en fazla 10 MB; saatte 60, hesap başına 500). WebP 1080 + 320, EXIF/GPS silinir
• DELETE/me/adventures/{id}/memories/photos/{photoId}Yüklenen anı fotoğrafını sil (dosyalar da silinir)
• POST/DELETE/me/memories/{id}/shareAnıyı gönderi olarak paylaş / kitlesini değiştir (`{ visibility: public|followers|private, caption? }`) / paylaşımı kaldır
• GET/posts/{id}Gönderi (görme izni yoksa 404)
• GET/PUT/DELETE/posts/{id}/likeGönderi beğenisi: durum / beğen / geri al
• GET/POST/posts/{id}/commentsGönderi yorumları (`?cursor=`) / yorum ya da yanıt yaz (`{ body, parentId? }`, saatte 20)
• PATCH/DELETE/posts/{id}/comments/{commentId}Kendi yorumunu düzenle (ilk 15 dk) / sil (yorum ya da gönderi sahibi)
• POST/posts/{id}/comments/{commentId}/reportGönderi yorumunu bildir (`{ reason }`)
• POST/posts/{id}/reportGönderiyi bildir (`{ reason }`)
• GET/feed/followingAkış: takip ettiklerinin (ve kendi) paylaşımları, `?cursor=`
• GET/users/{username}Profil: ad, bio, fotoğraf, gizlilik, sayılar (takipçi/takip/anı/yer/rozet), ilişki (self|blocked|following|pending|none), canView
• GET/users/{username}/postsProfil gönderi ızgarası (`?cursor=`); gizli hesapta takip etmeyene `locked: true`
• GET/users/{username}/visitsProfilin gezdiği yerler (görünürlük ayarına göre, yoksa 403)
• GET/users/{username}/badgesProfilin rozet rafı (görünürlük ayarına göre, yoksa 403)
• GET/users/{username}/boardsProfilin panoları (görebildiklerin)
• GET/users/{username}/followers, /followingTakipçiler / takip edilenler (gizli hesapta yalnızca takipçilere)
• GET/plans/{id}/adventurePlanın serüven listesi (girişsiz kısmi önizleme)
• GET/PATCH/plans/{id}/checklistRezervasyon ve hazırlık listesi (bilet seçenekleri, konaklama, hazırlık); plan sahibi `{ stepId, done?, selected? }` ile işaretler
• GET/plans/{id}/insights/liveGün gün programın güncel yer önerileriyle zenginleşmiş hâli (`status`: ready / pending / off)
• PUT/DELETE/destinations/{slug}/saveRotayı kaydet / çıkar
• POST/plans/{id}/emailPlanı kendi e-postana gönder
• POST/prices/researchCanlı fiyat araştırması (doğrulanmış hesap)
• GET/PATCH/me/profileProfil ve gizlilik ayarları (GET ayrıca `hasPassword` ve bağlı giriş yöntemleri `signInMethods`)
• POST/me/apple-authorizationUygulama: Apple `authorizationCode`'unu (`{ code }`) sunucuda takasla; hesap silinince Apple erişimi iptal edilir
• POST/DELETE/me/avatarProfil fotoğrafı yükle (multipart `file` ya da ham image/*, en fazla 5 MB; saatte 10) / kaldır
• GET/PUT/me/newsletterHaftalık bülten tercihi
• GET/POST/me/api-keysAPI anahtarlarını listele / oluştur
• DELETE/me/api-keys/{id}API anahtarını iptal et
• POST/newsletterBülten aboneliği (çift onay)
• GET/POST/me/shared-plansTopluluk planlarım / kendi planını paylaş (taslak ya da incelemeye gönder)
• PATCH/DELETE/me/shared-plans/{id}Topluluk planını düzenle (yayındaysa yeniden incelemeye girer) / sil
• PUT/DELETE/me/shared-plans/{id}/publishTopluluk planını incelemeye gönder / yayından kaldır
• POST/community-plans/{slug}/saveTopluluk planının kopyasını planlarına kaydet
• GET/PUT/DELETE/community-plans/{slug}/likeTopluluk planı beğenisi: durum / beğen / beğeniyi geri al
• GET/POST/community-plans/{slug}/commentsYorumlar (`?cursor=`, herkese açık) / yorum ya da yanıt yaz (`{ body, parentId? }`, saatte 20)
• PATCH/DELETE/comments/{id}Kendi yorumunu düzenle (ilk 15 dk) / sil (yorum sahibi ya da plan sahibi)
• POST/comments/{id}/reportYorumu editörlere bildir (`{ reason }`, yorum başına bir kez)
• GET/admin/shared-plansYönetim: topluluk planı inceleme kuyruğu (doğrulanmış yönetici)
• POST/admin/shared-plans/{id}Yönetim: topluluk planını onayla / reddet
• POST/admin/comments/{id}Yönetim: yorumu gizle / sil / geri al, bildirimleri kapat
• POST/admin/posts/{id}Yönetim: anı gönderisini gizle / geri al / sil, bildirimleri kapat
• POST/admin/post-comments/{id}Yönetim: gönderi yorumunu gizle / sil / geri al, bildirimleri kapat

• Verileri gösterdiğin yerde “Kaynak: dolasiyo.com” bağlantısı ver. Fotoğrafların lisansları (Wikipedia/Wikimedia) ve harita verisi (© OpenStreetMap katkıcıları) kendi atıflarını gerektirir; credit alanını göster.
• Fiyatlar tahmindir; kullanıcılarına “tahmini” olarak sun, rezervasyon ya da ödeme vaadi gibi gösterme.
• Toplu veri çekmek, veri setini yeniden satmak ya da rakip bir veri tabanı kurmak yasaktır. Yanıtları en fazla 24 saat önbellekle.
• Sınırları aşmak için birden çok anahtar ya da hesap kullanmak anahtarların iptaline yol açar.
• Kişisel veriler (kullanıcı planları, profiller) yalnızca sahibinin izniyle ve KVKK kapsamında işlenebilir.
• Hizmet “olduğu gibi” sunulur; kesintisiz çalışma garantisi verilmez. Koşullar bu sayfada güncellenir.

Daha yüksek kota, özel entegrasyon ya da iş birliği için: [email protected] · WhatsApp +90 543 313 35 26