API dokümantasyonu: imza oluşturma

⚡ Hızlı başlangıç

Kayıttan ilk imzanıza üç adım.

🔗 Temel URL

Tüm yanıtlar JSON'dur. Başarıda: { "success": true, "data": {…}, "meta": {…} }; hatada: { "success": false, "error": { "code", "message" } }.

https://onlinesignatures.net/api/v1

🔑 Kimlik doğrulama

Her istek, Authorization başlığında bir Bearer belirteci gerektirir. Anahtarları hesabınızdaki API sayfasında oluşturup yönetin — anahtarın tamamı yalnızca bir kez gösterilir.

curl https://onlinesignatures.net/api/v1/usage \
  -H "Authorization: Bearer sk_live_your_token"

🎨 Çıktı biçimleri

Varsayılan olarak imza, saydam PNG olarak döndürülür. Başka bir biçim için format parametresini ekleyin — bu ek kota harcamaz.

Anahtarlar = bu planda kaç API anahtarı oluşturabileceğiniz. İstek / ay ana kotadır; istek / dakika ani yük sınırıdır.

🔍 Görsel kalitesi

Varsayılan olarak imza standart kalitede (1×) döndürülür. Daha büyük ve net bir görsel için quality parametresini ekleyin: 2× piksellerin iki katı, 4× dört katıdır. Ek kota harcanmaz.

curl -X POST https://onlinesignatures.net/api/v1/signatures \
 -H "Authorization: Bearer sk_live_..." \
 -H "Content-Type: application/json" \
 -d '{"first_name":"Signature",
      "last_name":"Generator",
      "format":"png",
      "quality":4}'

Aynı imza, başka bir kalitede

Aynı imzayı farklı bir kalitede almak için yanıttaki hash değerini kaydedin ve POST /api/v1/signatures/replay ile yeniden isteyin. Her çağrı bir istektir.

curl -X POST https://onlinesignatures.net/api/v1/signatures/replay \
 -H "Authorization: Bearer sk_live_..." \
 -H "Content-Type: application/json" \
 -d '{"hash":"eyJpdiI6...",
      "format":"png",
      "quality":4}'

Bir ad ve soyaddan yepyeni bir imza oluşturun.

curl -X POST https://onlinesignatures.net/api/v1/signatures \
 -H "Authorization: Bearer sk_live_..." \
 -H "Content-Type: application/json" \
 -d '{"first_name":"Signature",
      "last_name":"Generator"}'

curl -X POST https://onlinesignatures.net/api/v1/signatures \
 -H "Authorization: Bearer sk_live_..." \
 -H "Content-Type: application/json" \
 -d '{"first_name":"Signature",
      "last_name":"Generator",
      "format":"pdf"}'

Parametreler

{
  "success": true,
  "data": {
    "id": 1842,
    "hash": "eyJpdiI6...",
    "format": "pdf",
    "mime": "application/pdf",
    "signature": "data:application/pdf;
       base64,JVBER..."
  },
  "meta": { "quota": { "remaining":179 } }
}

{
  "success": false,
  "error": {
    "code": "format_not_allowed",
    "message": "The pdf format is
      not available on
      your plan."
  }
}

Daha önce oluşturulmuş bir imzayı hash değeriyle yeniden oluşturun. Biçimi ?format= ile de belirleyebilirsiniz.

curl "https://onlinesignatures.net/api/v1/signatures/{hash}?format=svg" \
  -H "Authorization: Bearer sk_live_your_token"

Planınızı, mevcut biçimleri, aylık sınırı, ne kadar kullandığınızı ve ne zaman sıfırlanacağını döndürür.

{
  "success": true,
  "data": {
    "plan": "Business",
    "formats": ["png", "svg", "jpg"],
    "rate_per_minute": 1000,
    "key": { "name": "Production", "masked": "sk_live_a1b2…8f9c" },
    "quota": { "limit": 500, "used": 321, "remaining": 179 }
  }
}

⏱️ Sınırlar ve kota

Aylık kota ana sınırdır ve planınıza bağlıdır (bkz. API planları). Ayrıca dakikadaki istek sınırı (yine plana göre) ani yüklere karşı korur. Yanıtlar, kendinizi sınırlayabilmeniz için X-Quota-Limit, X-Quota-Remaining ve X-Quota-Reset başlıklarını içerir. Biçim değiştirmek ek kota harcamaz: bir oluşturma = bir istek.

⚠️ Hata kodları