YouSoft dış API’si
YouSoft ön muhasebe uygulamasındaki cari, stok, fatura ve e-belge verilerine kendi sunucunuzdan erişmek için kullanılan JSON tabanlı HTTP API. Uçlar /v1 altındadır. Her istek firmaya özel API anahtarıyla gelir ve HMAC-SHA256 ile imzalanır; API tarayıcıdan çağrılmaz.
Taban adres: https://api.yousoft.com.tr. İlk kez entegrasyon yazıyorsanız sayfaları yan menüdeki sırayla okuyun.
3 adımda başlayın
API anahtarı firma başına üretilir: müşteri panelinde Ayarlar → Web Servis Tanımları ekranından alınır. Güvenlik anahtarı (secret) yalnız üretim anında bir kez gösterilir.
Her istek güvenlik anahtarıyla HMAC-SHA256 ile imzalanır. Kodunuzu yayımlanmış test vektörüyle doğrulayın: hex birebir tutmuyorsa kanonik dizeniz sapıyor demektir.
GET
/v1/meanahtarın kimliğini döndürür ve hiçbir kapsam istemez; kurulumu doğrulamanın en ucuz yolu budur.
Dokümanlar
Başlarkenİlk isteğe kadar en kısa yol.
Kimlik doğrulamaHer isteğin nasıl imzalandığı.
RehberlerAdım adım, örnekli anlatımlar.
- Fatura kesme akışıCari kartı hazırlayın, taslağı yazın, gönderin ve sonucu izleyin; faturaları listeleme, XML ve PDF indirme, iptal ve gelen faturalar.
- Uç haritasıTüm uçlar kaynağına göre ve gereken kapsamıyla; “fatura nasıl kesilir” gibi sorulara kısa yol.
- Postman ile deneyinHer isteği otomatik imzalayan koleksiyonla API’yi kod yazmadan deneyin.
- Paraşüt’ten geçişParaşüt API’siyle çalışmış geliştiriciler için kaynak adı eşlemesi ve temel farklar.
BaşvuruKuralların ve sözleşmenin kendisi.
- OpenAPI referansıTüm uçlar, alanlar ve yanıtlar. Canlı sözleşmeden (GET /v1/openapi.yaml) üretilir.
- Sorgu sözleşmesiSayfalama, süzme, sıralama, genişletme, Idempotency-Key, oran sınırı ve yeniden deneme kuralları.
- Hata kodlarıHata yanıtının biçimi, dokuz hata kodunun anlamı ve her durumda ne yapacağınız.