x402 API

Koddan mektup postalayın, USDC ile ödeyin

Uygulamalar ve yapay zekâ ajanları Avustralya'nın her yerine mektup postalayabilir ve x402 üzerinden mektup başına USDC ile ödeyebilir. Hesap, API anahtarı veya abonelik yok: yalnızca bir cüzdan ve bir HTTP istemcisi.

10 USDC Normal posta ile mektup başına20 USDC Express Post ile mektup başına

Düz olarak en fazla 20 sayfa için tek fiyat, GST dahil. Base üzerinde USDC ile ödenir; gas bizden.

Hızlı başlangıç OpenAPI belirtimi

Neden x402 üzerinden mektup postalamalı?

Web sitesindekiyle aynı mektup, ödemesi HTTP üzerinden.

Hesap veya API anahtarı yok Kaydolmanız gereken bir şey yok. Kodunuz bir mektup oluşturur, fiyat alır ve imzalı bir USDC ödemesiyle öder.
Mektup başına sabit fiyat B4 zarfta düz olarak Express Post ile 20 USDC veya posta kutusuna sığacak şekilde katlanmış olarak Normal posta ile 10 USDC; katlanmış en fazla 12, düz en fazla 20 sayfa için baskıyı, zarfı, posta ücretini ve takibi kapsar, sonrası sayfa başına 0.30 USDC. GST dahildir, gas de bizden.
Web sitesindekiyle aynı mektup 80gsm A4'e yüklendiği gibi basılır, takiplidir ve Melbourne saatiyle 14:30'a kadar ödenirse aynı iş günü postalanır.
Postalanamazsa ücreti iade edilir Postalayamazsak ödemeyi yapan cüzdana tutarın tamamını USDC olarak iade ederiz. Bizim iptal ettiğimiz bir mektup da aynı şekilde iade edilir.

Kimler için

Yapay zekâ ajanları Bir depozito anlaşmazlığı, sigorta talebi veya belediye şikâyetiyle ilgilenen bir ajan, mektubu kendisi postalayabilir ve kendi cüzdanından ödeyebilir.
Uygulamalar ve betikler Üye işyeri hesabı veya aylık plan olmadan mektup postalayan mülk yönetimi, hukuk ve faturalama yazılımları.

Beş istek, bir mektubu kodunuzdan postaya ulaştırır. Hesap veya anahtar yoktur: ihtiyacımız olan tek şey ödemedir.

send-letter.sh

# 1. Create the letter
curl -X POST https://unopost.com.au/api/x402 \
  -H "Content-Type: application/json" \
  -d '{
  "fileName": "notice.pdf",
  "recipient": {
    "name": "Ruth Mitchell",
    "line1": "7 High Street",
    "suburb": "Echuca",
    "postcode": "3564"
  },
  "sender": {
    "name": "Sam Nguyen",
    "company": "Nguyen Property",
    "line1": "14 Carnarvon Street",
    "suburb": "Broome",
    "postcode": "6725"
  },
  "service": "express",
  "signature": true
}'

# 2. Upload the document to the uploadUrl you got back
curl -X PUT "$UPLOAD_URL" \
  -H "Content-Type: application/pdf" \
  --data-binary @notice.pdf

# 3. Poll until the status is ready_to_send, and check the price
curl https://unopost.com.au/api/x402/$JOB_ID

# 4. Ask to send it: the 402 says what to pay
curl -i -X POST https://unopost.com.au/api/x402/$JOB_ID/send

# 5. Sign the payment with an x402 client, and send it again
curl -i -X POST https://unopost.com.au/api/x402/$JOB_ID/send \
  -H "PAYMENT-SIGNATURE: $PAYMENT_SIGNATURE"

Uç noktalar

Uç noktalar https://unopost.com.au adresine görelidir. İstekler ve yanıtlar JSON biçimindedir; hatalar {"error": "..."} biçimindedir. Tam başvuru: OpenAPI belirtimi.

Temel URL

https://unopost.com.au

POST/api/x402Mektup oluşturur. Ücretsiz.PUTuploadUrlBelgeyi mektubun imzalı bağlantısına yükler.GET/api/x402/{jobId}Mektubun durumunu, fiyatını ve takip bilgisini getirir.POST/api/x402/{jobId}/sendUSDC ile ödenir ve mektup baskıya gider.

Mektup oluşturun

POST/api/x402

Dosya adını, alıcının adresini ve iade adresinizi POST ile gönderin. Bir jobId, imzalı bir uploadUrl ve mektubu sorgulamak ve ödemek için URL'ler alırsınız.

İstek gövdesi

fileNamestring · zorunlu: Uzantısıyla birlikte dosya adı: .pdf, .doc, .docx, .jpg, .jpeg veya .png.
recipientAddress · zorunlu: Mektubun postalanacağı adres.
senderAddress · zorunlu: İade adresiniz; teslim edilemeyen postanın size geri dönmesi için zarfın üzerine basılır.
servicestring · isteğe bağlı: Express Post için "express" (varsayılan) veya Normal posta için "regular".
duplexboolean · isteğe bağlı: Çift taraflı basar. Varsayılan değer false. Statutory declaration belgeleri (yasal beyannameler) her zaman tek taraflı basılır.
monoboolean · isteğe bağlı: Siyah beyaz basar. Varsayılan değer false: içinde renk bulunan bir belge renkli basılır.
stapleboolean · isteğe bağlı: Sayfaları sol üst köşeden bir kez zımbalar. Yalnızca en fazla 12 sayfalık belgeler için; daha uzun bir belge fiyatlandırılırken reddedilir. Varsayılan değer false.
foldboolean · isteğe bağlı: Yalnızca Express Post: mektubu B4 zarfta düz postalamak yerine, ek ücret almadan C5 zarfa katlar. 20 sayfadan uzun belgelerde yok sayılır; bunlar düz gider. Normal posta mektupları her zaman katlanır.
signatureboolean · isteğe bağlı: Teslimatta imza; her iki hizmette de ek 6 USDC. regular ile mektup Taahhütlü posta olarak gider.

Adres

Alıcı Avustralya'da olmalıdır. İade adresi herhangi bir yerde olabilir: ülkesini belirtin, posta kodu isteğe bağlı hale gelir. Her satır en fazla 40 karakter olabilir.

namestring · isteğe bağlı: Kişinin tam adı.
companystring · isteğe bağlı: Bir işletme veya kuruluş.
line1string · zorunlu: Sokak adresi veya "PO Box 123" gibi bir PO Box.
line2string · isteğe bağlı: İkinci adres satırı.
suburbstring · zorunlu: Semt (suburb) veya kasaba.
statestring · isteğe bağlı: Avustralya için boş bırakın: posta kodu eyaleti belirler. Verilirse, posta koduyla eşleşen ACT, NSW, NT, QLD, SA, TAS, VIC veya WA değerlerinden biri olmalıdır.
postcodestring · zorunlu: Dört hane.
countrystring · isteğe bağlı: Yalnızca iade adresi için. Avustralya için boş bırakın.

İstek

curl -X POST https://unopost.com.au/api/x402 \
  -H "Content-Type: application/json" \
  -d '{
  "fileName": "notice.pdf",
  "recipient": {
    "name": "Ruth Mitchell",
    "line1": "7 High Street",
    "suburb": "Echuca",
    "postcode": "3564"
  },
  "sender": {
    "name": "Sam Nguyen",
    "company": "Nguyen Property",
    "line1": "14 Carnarvon Street",
    "suburb": "Broome",
    "postcode": "6725"
  },
  "service": "express",
  "signature": true
}'

Yanıt 200

{
  "jobId": "019d7a7f-a183-752d-9b3b-11511179033b",
  "uploadUrl": "https://unopost.com.au/uploads/019d7a7f-a183-752d-9b3b-11511179033b/notice.pdf?Expires=...&Signature=...&Key-Pair-Id=...",
  "statusUrl": "/api/x402/019d7a7f-a183-752d-9b3b-11511179033b",
  "sendUrl": "/api/x402/019d7a7f-a183-752d-9b3b-11511179033b/send",
  "status": "awaiting_upload"
}

Belgeyi yükleyin

PUTuploadUrl

Ham dosya baytlarını 15 dakika içinde PUT ile uploadUrl adresine gönderin. En fazla 50 MB ve 80 sayfa. A4'e yerleştirme, yükleme ulaşır ulaşmaz başlar; başka bir çağrı yapmanız gerekmez.

İstek

curl -X PUT "$UPLOAD_URL" \
  -H "Content-Type: application/pdf" \
  --data-binary @notice.pdf

Mektubu getirme

GET/api/x402/{jobId}

Fiyatı bekleyin

status değeri ready_to_send olana kadar birkaç saniyede bir sorgulayın. Bu aşamada yanıtta sayfa sayısı, payment içinde fiyat, sendUrl ve ödeme yapmadan önce kontrol edebileceğiniz baskıya hazır PDF için bir previewUrl bulunur.

fold artık hizmete göre belirlenir: Normal posta için true, Express Post için false. duplex ise false olabilir: statutory declaration belgeleri tek taraflı basılır. 12 sayfayı aşan bir Normal posta mektubu, fiyatlandırılırken reddedilir.

Mektubu izleyin

Mektup posted, ardından delivered olana kadar, daha seyrek aralıklarla sorgulamayı sürdürün. E-posta gönderilmez; her güncelleme durumda görünür.

İstek

curl https://unopost.com.au/api/x402/$JOB_ID

Yanıt 200 · ready_to_send

{
  "jobId": "019d7a7f-a183-752d-9b3b-11511179033b",
  "service": "express",
  "duplex": false,
  "mono": false,
  "fold": false,
  "signature": true,
  "recipient": {
    "name": "Ruth Mitchell",
    "line1": "7 High Street",
    "suburb": "Echuca",
    "postcode": "3564"
  },
  "sender": {
    "name": "Sam Nguyen",
    "company": "Nguyen Property",
    "line1": "14 Carnarvon Street",
    "suburb": "Broome",
    "postcode": "6725"
  },
  "pageCount": 3,
  "status": "ready_to_send",
  "previewUrl": "/preview/019d7a7f-a183-752d-9b3b-11511179033b/notice.pdf?Expires=...&Signature=...&Key-Pair-Id=...",
  "payment": {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amountAtomic": "20000000",
    "amountDisplay": "20 USDC",
    "payTo": "0x1111111111111111111111111111111111111111",
    "expiresAt": "2026-09-25T02:15:00Z"
  },
  "sendUrl": "/api/x402/019d7a7f-a183-752d-9b3b-11511179033b/send"
}

Yanıt 200 · posted

{
  "jobId": "019d7a7f-a183-752d-9b3b-11511179033b",
  "service": "express",
  "duplex": false,
  "mono": false,
  "fold": false,
  "signature": true,
  "recipient": {
    "name": "Ruth Mitchell",
    "line1": "7 High Street",
    "suburb": "Echuca",
    "postcode": "3564"
  },
  "sender": {
    "name": "Sam Nguyen",
    "company": "Nguyen Property",
    "line1": "14 Carnarvon Street",
    "suburb": "Broome",
    "postcode": "6725"
  },
  "pageCount": 3,
  "status": "posted",
  "providerReference": "LTR-8F3A21C9"
}

Ödeyin ve postalayın

POST/api/x402/{jobId}/send

Ödeme olmadan sendUrl adresine POST gönderin. Yanıt 402 Payment Required olur; ödeme gereksinimleri base64 ile kodlanmış olarak PAYMENT-REQUIRED üstbilgisinde yer alır.

Ödemeyi x402 protokolünün tanımladığı şekilde imzalayın (veya bunu bir x402 istemci kitaplığına bırakın) ve isteği, yük bir PAYMENT-SIGNATURE üstbilgisinde olacak şekilde yeniden gönderin. Ödemeyi doğrular ve mutabakatını yaparız; mektup baskıya gider. Mutabakat bilgisi PAYMENT-RESPONSE üstbilgisindedir.

ready_to_send durumundan hemen sonra job not ready to send ile 409 mu aldınız? Bir an bekleyip yeniden deneyin. Ödemeden sonra yeniden çağırmak, iki kez ücret almadan durumu döndürür.

İstek

curl -i -X POST https://unopost.com.au/api/x402/$JOB_ID/send

Yanıt 402

HTTP/2 402
payment-required: eyJ4NDAyVmVyc2lvbiI6Mi...

{
  "error": "payment required"
}

PAYMENT-REQUIRED üstbilgisi, base64 kodu çözülmüş

{
  "x402Version": 2,
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "20000000",
      "payTo": "0x1111111111111111111111111111111111111111",
      "maxTimeoutSeconds": 300,
      "extra": {
        "name": "USD Coin",
        "version": "2"
      }
    }
  ]
}

İstek

curl -i -X POST https://unopost.com.au/api/x402/$JOB_ID/send \
  -H "PAYMENT-SIGNATURE: $PAYMENT_SIGNATURE"

Yanıt 202

HTTP/2 202
payment-response: eyJzdWNjZXNzIjp0cnVlLC...

{
  "jobId": "019d7a7f-a183-752d-9b3b-11511179033b",
  "status": "sending"
}

Durumlar

awaiting_upload: Dosya bekleniyor.
processing: Belge A4'e yerleştiriliyor ve fiyatlandırılıyor.
ready_to_send: Fiyatlandırıldı ve ödeme bekliyor. Fiyat teklifi 7 gün geçerlidir.
sending: Ödendi ve baskı kuyruğuna alındı.
retrying: Baskıda bir sorun oluştu; otomatik olarak yeniden deniyoruz.
posted: Basıldı ve Australia Post'a teslim edildi.
delivered: Australia Post tarafından alıcıya teslim edildi. Belge, postaya verilirken silindi.
failed: Postalanmadı; nedeni error içindedir, örneğin ödenmeden süresi dolan bir fiyat teklifi. Ödemesi yapılmış olup postalanamayan bir mektubun ücreti tam olarak iade edilir.
refunded: Ödeme, onu yapan cüzdana geri gönderildi.

Hatalar

400: Geçersiz istek: örneğin eksik bir alan, desteklenmeyen dosya türü, 40 karakteri aşan adres satırı, eyaletle uyuşmayan posta kodu, Normal posta ile teslimatta imza, veya 12 sayfayı aşan bir Normal posta mektubu.
402: Ödeme gerekiyor veya ödeme doğrulanamadı ya da mutabakatı yapılamadı. Nedeni error içinde belirtilir.
404: Bu jobId ile bir mektup yok.
409: job not ready to send: ready_to_send durumunu bekleyip yeniden deneyin. quote expired: mektubu yeniden oluşturun.

Sık sorulan sorular

x402 nedir?

HTTP üzerinden ödeme yapmak için açık bir protokol. Sunucu bir fiyatla birlikte 402 Payment Required yanıtını verir; istemci bir stablecoin ödemesi imzalar ve isteği yeniden gönderir. Hesap, kart veya fatura yok.

Neye ihtiyacım var?

Base üzerinde yeterli USDC bulunan bir cüzdana ve bir HTTP istemcisine. Gas için ETH gerekmez: ödeme, imzalı bir USDC transfer yetkisidir ve ağ ücretini biz karşılarız.

Bir mektup ne kadar tutar?

Express Post ile en fazla 20 sayfa için 20 USDC, sonrası sayfa başına 0.30 USDC; veya Normal posta ile en fazla 12 sayfalık bir mektup için 10 USDC; GST dahil. Teslimatta imza her iki hizmette de ek 6 USDC tutarındadır; teslimatta imzalı Normal posta, Taahhütlü postadır: 16 USDC. Takip, çift taraflı ve siyah beyaz baskı, 12 sayfaya kadar zımbalama ile Express Post mektubunun pencereli DL zarfa katlanması ücretsizdir. Durum yanıtı, ödeme yapmadan önce kesin fiyatı gösterir.

Ödemeden önce mektubu kontrol edebilir miyim?

Evet. Gönderime hazır olduğunda previewUrl, tam basılacağı haliyle A4'e yerleştirilmiş, baskıya hazır PDF'i verir. Siz ödeyene kadar hiçbir ücret alınmaz.

Ne zaman postalanır ve ulaşması ne kadar sürer?

Bir iş gününde Melbourne saatiyle 14:30'a kadar ödenen mektuplar aynı gün, daha sonra ödenenler ertesi iş günü postalanır. Express Post, Express Post ağı içinde genellikle ertesi iş günü; Normal posta ise 3–7 iş günü içinde ulaşır.

Mektup postalanamazsa ne olur?

Durumu failed olarak değişir ve ister başarısız olmuş ister biz iptal etmiş olalım, tutarın tamamını USDC olarak ödemeyi yapan cüzdana iade ederiz. Diğer her konu için jobId ile birlikte support@unopost.com.au adresine e-posta gönderin.

Belgeme ne olur?

Aktarım sırasında şifrelenir ve mektup Australia Post'a teslim edildiğinde, baskıya hazır kopyasıyla birlikte kalıcı olarak silinir. Bir mektubun ödemesi yapılmazsa veya mektup postalanamazsa 14 gün sonra silinir.

Mektuplar nereye gönderilebilir?

Her eyalet ve bölgede, PO Box'lar dahil, Avustralya'daki herhangi bir adrese. API yurt dışına gönderim yapmaz.

Bir ajanın gönderdiklerinden kim sorumludur?

Siz. Cüzdanınızdan ödenen her mektup, bir ajanın sizin talimatınızla yazıp gönderdiği mektup dahil, sizindir ve içindekileri göndermeye hakkınız olmalıdır. Koşullarımız postayla gönderilemeyecekleri sayar: başkasının kimliğine bürünme, taciz, dolandırıcılık, toplu halde istenmeyen reklam ve bir mahkeme kararını ihlal eden her şey. Bu kuralları çiğneyen mektupları iptal eder ve ücretin tamamını iade ederiz. Başkası adına gönderim yapıyorsanız, onun belgesinden kendi belgenizmiş gibi sorumlusunuz.

Fiyatlar

Kalem	Fiyat
Normal posta, posta kutusuna sığacak şekilde katlanmış: en fazla 12 sayfa	10 USDC
Taahhütlü posta, teslimatta imzalı Normal posta: en fazla 12 sayfa	16 USDC
Express Post, B4 zarfta düz: 20 sayfa dahil, sonraki her sayfa için 0.30 USDC	20 USDC
Teslimatta imzalı Express Post: 20 sayfa dahil, sonraki her sayfa için 0.30 USDC	26 USDC
Takip, renkli, çift taraflı veya siyah beyaz baskı ve zımbalama	Ücretsiz
Ağ ücreti (gas)	Bizden

Fiyatlar Base üzerinde USDC cinsindendir. Fiyat, belgeniz A4'e yerleştirildikten sonra belirlenir; fiyat teklifleri 7 gün geçerlidir.

Fiyatlar değişebilir. Bu hizmetin kullanımı Hizmet Koşullarımıza ve Gizlilik Politikamıza tabidir.