Frihet REST API'si

Faturalara, müşterilere, giderlere, ürünlere ve tekliflere programatik erişim. Ölçeklenebilir entegrasyonlar için tasarlanmıştır.

https://api.frihet.io/v1 v1 — 2026-03-18

Geliştiriciler için tasarlandı

Kısmi Güncellemeler PATCH

Sadece ihtiyacınız olan alanları güncelleyin. Zod ile doğrulanmış kısmi şemalar bütünlüğü garanti eder.

Arama ve Filtreler

?q= parametresiyle tam metin arama. Doğru sonuçlar için kaynak bazında alan eşleme.

Toplu İşlemler

Tek bir istekte 50 adede kadar kaynak oluşturun. HTTP 207 çoklu durum yanıtları.

Idempotency Anahtarları

Idempotency-Key başlığıyla istekleri güvenli bir şekilde tekrar deneyin. 24 saatlik TTL, Firestore tarafından desteklenir.

Oran Limiti Başlıkları

Her yanıtta X-RateLimit-Limit, Remaining ve Reset. Buna göre plan yapın.

OpenAPI 3.1 Spesifikasyonu

/openapi.yaml adresinde makine tarafından okunabilir spesifikasyon. 16 yol, 18 şema. SDK'ları otomatik olarak oluşturur.

Akıllı Uç Noktalar

/context, /monthly, /quarterly aracılığıyla iş bağlamı, aylık özetler ve üç aylık vergi verileri.

VeriFactu Güvenli Silme

Taslak olmayan faturalar ve teklifler için geçici silme. İspanyol vergi uyumluluğu için tam izlenebilirlik.

Uç Noktalar

Method	Path	Description
GET	/v1/invoices	Faturaları Listele
POST	/v1/invoices	Fatura Oluştur
PATCH	/v1/invoices/:id	Faturayı Güncelle
DELETE	/v1/invoices/:id	Faturayı Sil
POST	/v1/invoices/batch	Toplu Faturalar Oluştur
GET	/v1/clients	Müşterileri Listele
POST	/v1/clients	Müşteri Oluştur
GET	/v1/expenses	Giderleri Listele
POST	/v1/expenses	Gider Oluştur
GET	/v1/products	Ürünleri Listele
GET	/v1/quotes	Teklifleri Listele
GET	/v1/context	İş Bağlamı
GET	/v1/monthly	Aylık Özet
GET	/v1/quarterly	Üç Aylık Vergiler
GET	/openapi.yaml	OpenAPI Spesifikasyonu

Kod Örnekleri

curl https://api.frihet.io/v1/invoices \
  -H "Authorization: Bearer fri_..." \
  -H "Content-Type: application/json"

const res = await fetch('https://api.frihet.io/v1/invoices', {
  headers: {
    'Authorization': 'Bearer fri_...',
    'Content-Type': 'application/json',
  },
});
const { data, meta } = await res.json();

import requests

res = requests.get(
    'https://api.frihet.io/v1/invoices',
    headers={'Authorization': 'Bearer fri_...'}
)
data = res.json()['data']

Kimlik Doğrulama

Frihet panelinizdeki Ayarlar > API bölümünden API anahtarları oluşturun. Anahtarınızı Authorization başlığında Bearer token olarak ekleyin.

Authorization: Bearer fri_...

Tam API Dokümantasyonu MCP Server

Bugün Entegrasyona Başlayın

Tüm planlarda API erişimi dahildir. API anahtarınız Ayarlar'da hazır.

Ücretsiz Başla