Documentație API pentru generarea semnăturilor

⚡ Start rapid

Trei pași de la înregistrare la prima semnătură.

🔗 Adresă de bază

Toate răspunsurile sunt JSON. La succes: { "success": true, "data": {…}, "meta": {…} }; la eroare: { "success": false, "error": { "code", "message" } }.

https://onlinesignatures.net/api/v1

🔑 Autentificare

Fiecare solicitare are nevoie de un token Bearer în antetul Authorization. Cheile se creează și se gestionează pe pagina API din contul tău — cheia completă este afișată o singură dată.

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

🎨 Formate de ieșire

Implicit, semnătura este returnată ca PNG cu fundal transparent. Adaugă parametrul format pentru a obține alt format — acesta nu consumă cotă suplimentară.

Chei — câte chei API poți crea în acest plan. Solicitări / lună este cota principală; solicitări / minut este limita de vârf.

🔍 Calitatea imaginii

În mod implicit, semnătura este returnată la calitate standard (1×). Adaugă parametrul quality pentru o imagine mai mare și mai clară: 2× înseamnă dublul pixelilor, 4× de patru ori mai mulți. Nu consumă cotă suplimentară.

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}'

Aceeași semnătură la altă calitate

Pentru a obține exact aceeași semnătură la altă calitate, salvează hash din răspuns și cere-o din nou prin POST /api/v1/signatures/replay. Fiecare apel este o cerere.

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}'

Generează o semnătură nouă pornind de la prenume și nume.

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"}'

Parametri

{
  "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."
  }
}

Redesenează o semnătură creată anterior, folosind hash-ul acesteia. Formatul poate fi indicat și prin ?format=.

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

Returnează planul tău, formatele disponibile, limita lunară, cât ai consumat și când se resetează.

{
  "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 }
  }
}

⏱️ Limite și cotă

Cota lunară este limita principală și depinde de planul tău (vezi Planuri API). În plus, există o limită de solicitări pe minut (tot în funcție de plan), care protejează împotriva vârfurilor. Răspunsurile includ antetele X-Quota-Limit, X-Quota-Remaining și X-Quota-Reset, ca să îți poți regla singur ritmul. Schimbarea formatului nu consumă cotă suplimentară: o generare = o solicitare.

⚠️ Coduri de eroare