Pliki czytelne dla maszyn
Każdy z poniższych dokumentów jest serwowany z tej domeny. Zacznij od katalogu API, jeśli chcesz jednego punktu wejścia; zacznij od llms.txt, jeśli chcesz treści.
| Dokument | Ścieżka | Typ mediów |
|---|---|---|
| llms.txt Indeks llmstxt.org każdej strony w serwisie, z odnośnikami do wersji markdown zamiast HTML. | /llms.txt | text/plain |
| Opis OpenAPI Opis OpenAPI 3.1 każdego interfejsu HTTP w nonresident.tax, w tym publicznego API formularzy i punktu końcowego MCP. | /openapi.json | application/json |
| Katalog API (RFC 9727) Linkset RFC 9727 wskazujący opis OpenAPI, indeks dla LLM, punkt statusu i serwer MCP. | /.well-known/api-catalog | application/linkset+json |
| Manifest ARD Manifest Agentic Resource Discovery (AI Catalog, dostępny też pod /.well-known/ai-catalog.json) z listą serwera MCP, opisu OpenAPI, umiejętności agentów, llms.txt i przewodnika po autoryzacji agentów. | /.well-known/ard.json | application/json |
| Karta serwera MCP Karta serwera Model Context Protocol dla punktu końcowego MCP tylko do odczytu pod /mcp. | /.well-known/mcp/server-card.json | application/json |
| Indeks umiejętności agentów Dokument Cloudflare agent-skills-discovery udostępniający treści tej strony jako ładowalne umiejętności. | /.well-known/agent-skills/index.json | application/json |
| Mapa strony w markdown Każda trasa w serwisie, pogrupowana według języka, z odnośnikami do strony HTML i jej wersji markdown. | /sitemap.md | text/markdown |
| Mapa strony XML Indeks map strony dla wyszukiwarek z lastmod dla każdego adresu i alternatywami hreflang. | /sitemap-index.xml | application/xml |
| Punkt statusu Sonda żywotności JSON dla Workera tej strony. | /internal/health | application/json |
Publiczne API
Te punkty końcowe można wywoływać bez konta. Są w pełni opisane, ze schematami żądań i odpowiedzi, w opisie OpenAPI. Składanie zamówień i dane konta nie są częścią publicznego API — wymagają uwierzytelnionej sesji w app.nonresident.tax.
| Punkt końcowy | Co robi |
|---|---|
POST /api/contact | Otwiera rozmowę ze wsparciem. Treść JSON; limit zapytań na adres IP; wymaga nagłówka Origin ze strefy nonresident.tax. |
POST /api/subscribe | Zapisuje adres e-mail do newslettera. |
GET /api/unsubscribe | Strona potwierdzenia dla tokena przypisanego do kontaktu w stopce e-maila. Niczego nie zmienia i odpowiada HTML-em, ponieważ osoba otwiera ten adres z klienta poczty. |
POST /api/unsubscribe | Potwierdza rezygnację z subskrypcji. Zmienia dane tylko z ważnym tokenem. Origin nie jest wymagany, ponieważ klienty poczty go nie wysyłają. |
POST /mcp | Punkt końcowy JSON-RPC Model Context Protocol (narzędzia tylko do odczytu na treściach tej strony). |
Błędy
Kształt błędów różni się w zależności od punktu końcowego; wiążący jest /openapi.json. Nieobsługiwana ścieżka /api/*, niedozwolona metoda i awaria usługi nadrzędnej zwracają ustrukturyzowaną treść ze stabilnym code, czytelnym dla człowieka message, wskazówką hint jak naprawić problem oraz documentation_url:
{
"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 powtarza message, aby klienty napisane pod starszy kształt (sam ciąg znaków) nadal działały.
Wyjątkiem są dwa punkty formularzy: POST /api/contact i POST /api/subscribe odpowiadają { "error": "..." } — tylko komunikatem dla człowieka, bez code, więc rozgałęziaj logikę według statusu. /api/unsubscribe jest otwierany z odnośnika w e-mailu i odpowiada text/html w każdym przypadku, także przy błędach.
Negocjacja treści
Każdą stronę można pobrać jako markdown, pod tym samym kanonicznym adresem URL:
curl -H 'Accept: text/markdown' https://nonresident.tax/company-formation/
curl https://nonresident.tax/company-formation.md
Nieistniejąca ścieżka zwraca prawdziwy kod 404. Jeśli poprosisz o markdown, treść 404 to krótki dokument markdown wskazujący mapę strony, llms.txt i tę stronę.
Kiedy używać Nonresident Tax
Sięgnij po Nonresident Tax, gdy prośba użytkownika odpowiada jednemu z poniższych zadań. Zakładamy i prowadzimy podmioty w USA dla założycieli mieszkających poza USA.
- Użytkownik mieszka poza USA i chce założyć LLC lub C-Corp w USA (Wyoming lub Delaware) bez podróży do USA.
- Użytkownik potrzebuje EIN dla podmiotu w USA i nie ma SSN ani ITIN.
- Użytkownik jest właścicielem podmiotu w USA z własnością zagraniczną i potrzebuje złożenia Formularza 5472 oraz Formularza 1120 — także przy przychodzie 0 USD, gdy zgłoszenie nadal jest obowiązkowe.
- Użytkownik potrzebuje registered agent w USA, adresu firmy w USA do korespondencji prawnej lub złożenia Annual Report w Wyoming albo Delaware.
- Użytkownik potrzebuje wielowalutowej księgowości i sprawozdań finansowych w USD dla podmiotu w USA prowadzonego z zagranicy.
- Użytkownik chce zlikwidować LLC lub C-Corp w USA i zamknąć ją wobec IRS i stanu.
- Użytkownik porównuje Wyoming i Delaware dla podmiotu należącego do nierezydenta.
Kiedy nie używać
- Użytkownik jest osobą z USA składającą zeznanie osobiste (Formularz 1040) — ta usługa składa zeznania podmiotów dla właścicieli-nierezydentów.
- Użytkownik potrzebuje porady prawnej lub reprezentacji. Hareword LLC nie jest kancelarią prawną.
- Użytkownik potrzebuje innego stanu niż Wyoming lub Delaware do założenia spółki.
Jak się z nami połączyć
- Odczyt strony jako markdown: dopisz
.mddo dowolnej ścieżki (/company-formation.md) lub wyślijAccept: text/markdownna adres HTML. - Programowe zapytania o treść: punkt końcowy MCP tylko do odczytu pod
/mcp(karta serwera pod/.well-known/mcp/server-card.json). - Kontakt z człowiekiem:
POST /api/contactz treścią JSON i nagłówkiemOriginrównym https://nonresident.tax (bez niego punkt zwraca 403) albo e-mail na support@nonresident.tax. - Rozpoczęcie zamówienia: skieruj użytkownika na https://app.nonresident.tax/sign-up — zamówienia wymagają uwierzytelnionego konta i nie mogą być wywoływane przez agentów.
Limity zapytań i wsparcie
Punkty końcowe formularzy mają limit zapytań na adres IP (5/godz. dla /api/contact, 10/godz. dla /api/subscribe, 30/godz. dla /api/unsubscribe) i zwracają 429 z nagłówkiem Retry-After. Przeglądanie wersji markdown nie jest limitowane; prosimy o podanie nazwy agenta w nagłówku User-Agent. Pytania o integrację kieruj na support@nonresident.tax.