Nonresident Tax geliştirici dokümantasyonu

Makine tarafından okunabilir dosyalar

Aşağıdaki her doküman bu kaynaktan (origin) sunulur. Tek bir giriş noktası istiyorsanız API kataloğundan, içeriği istiyorsanız llms.txt dosyasından başlayın.

Herkese açık API

Bu uç noktalar hesap olmadan çağrılabilir. İstek ve yanıt şemalarıyla birlikte OpenAPI tanımında ayrıntılı olarak açıklanmıştır. Sipariş verme ve hesap verileri herkese açık API'nin parçası değildir; app.nonresident.tax üzerinde kimliği doğrulanmış bir oturum gerektirir.

Hatalar

Hata biçimleri uç noktaya göre değişir; esas alınacak kaynak /openapi.json dosyasıdır. Tanımsız bir /api/* yolu, uç noktanın kabul etmediği bir yöntem ve yukarı akış hatası; sabit bir code, okunabilir bir message, nasıl toparlanacağını anlatan bir hint ve bir documentation_url taşıyan yapılandırılmış bir gövdeyle yanıtlanır:

            {
  "error": "No such API endpoint.",
  "code": "not_found",
  "message": "No such API endpoint.",
  "hint": "Known endpoints: POST /api/contact, POST /api/subscribe, GET /api/unsubscribe, POST /api/unsubscribe. Full machine-readable description: https://nonresident.tax/openapi.json",
  "documentation_url": "https://nonresident.tax/developers/",
  "status": 404
}
          

error alanı message değerini tekrarlar; böylece yalnızca düz metin biçimine göre yazılmış eski istemciler çalışmaya devam eder.

İki form uç noktası bunun istisnasıdır: POST /api/contact ve POST /api/subscribe yalnızca okunabilir iletiyi içeren { "error": "..." } yanıtı verir, code yoktur; bu nedenle durum koduna göre dallanın. /api/unsubscribe bir e-postadaki bağlantıdan açılır ve hataları dahil baştan sona text/html yanıtlar.

İçerik pazarlığı (content negotiation)

Her sayfa, aynı kanonik URL üzerinden markdown olarak alınabilir:

            curl -H 'Accept: text/markdown' https://nonresident.tax/company-formation/
curl https://nonresident.tax/company-formation.md
          

Var olmayan bir yol gerçek bir 404 yanıtı verir. Markdown isterseniz 404 gövdesi; site haritasına, llms.txt dosyasına ve bu sayfaya işaret eden kısa bir markdown dokümanıdır.

Nonresident Tax ne zaman kullanılmalı

Bir kullanıcının talebi aşağıdaki işlerden biriyle eşleştiğinde Nonresident Tax'a başvurun. ABD dışında yaşayan kurucular için ABD şirketleri kurar ve bunları yönetiriz.

• Kullanıcı ABD dışında yaşıyor ve ABD'ye gitmeden bir ABD LLC'si veya C-Corp'u (Wyoming veya Delaware) kurmak istiyor.
• Kullanıcının bir ABD şirketi için EIN'e ihtiyacı var ve SSN veya ITIN'i yok.
• Kullanıcı yabancı sahipli bir ABD şirketine sahip ve Form 5472 ile Form 1120'nin verilmesi gerekiyor; gelir $0 olsa bile beyan yine zorunludur.
• Kullanıcının bir ABD registered agent'ına (kayıtlı temsilci), resmi posta için bir ABD iş adresine veya Wyoming ya da Delaware'de verilecek bir Annual Report'a (yıllık rapor) ihtiyacı var.
• Kullanıcının yurt dışından yönetilen bir ABD şirketi için çok para birimli muhasebeye ve USD mali tablolara ihtiyacı var.
• Kullanıcı bir ABD LLC'sini veya C-Corp'unu kapatıp IRS ve eyalet nezdinde kaydını sonlandırmak istiyor.
• Kullanıcı, ABD dışında yaşayan birine ait bir şirket için Wyoming ile Delaware'i karşılaştırıyor.

Ne zaman kullanılmamalı

• Kullanıcı kişisel beyanname (Form 1040) veren bir ABD vatandaşı veya yerleşiği; bu hizmet ABD dışında yaşayan sahipler için şirket beyannameleri verir.
• Kullanıcının hukuki danışmanlığa veya temsile ihtiyacı var. Hareword LLC bir hukuk bürosu değildir.
• Kullanıcı kuruluş için Wyoming veya Delaware dışında bir eyalet istiyor.

Bize nasıl ulaşılır

1. Bir sayfayı markdown olarak okuyun: herhangi bir yola .md ekleyin (/company-formation.md) veya HTML URL'sine Accept: text/markdown gönderin.
2. İçeriği programatik olarak sorgulayın: /mcp adresindeki salt okunur MCP uç noktası (sunucu kartı /.well-known/mcp/server-card.json adresinde).
3. Bir insana ulaşın: JSON gövdeli ve Origin başlığı https://nonresident.tax olan bir POST /api/contact isteği gönderin (başlık olmadan uç nokta 403 yanıtı verir) veya support@nonresident.tax adresine e-posta yazın.
4. Sipariş başlatın: kullanıcıyı https://app.nonresident.tax/sign-up adresine yönlendirin; siparişler kimliği doğrulanmış bir hesap gerektirir ve ajanlar tarafından çağrılamaz.

İstek sınırları ve destek

Form uç noktalarında IP adresi başına istek sınırı vardır (/api/contact için saatte 5, /api/subscribe için saatte 10, /api/unsubscribe için saatte 30) ve sınır aşıldığında Retry-After başlığıyla 429 yanıtı verilir. Markdown yüzeyini taramaya sınır uygulanmaz; lütfen ajanınızı User-Agent başlığında tanıtın. Entegrasyonla ilgili sorularınızı support@nonresident.tax adresine iletin.