---
title: "למפתחים ולסוכני AI"
description: "Public read-only JSON API and OpenAPI 3.1 spec for Achiya Automation: services, pricing, FAQ and business profile. No auth, no rate limit. Markdown content negotiation and llms.txt for AI agents."
canonical: "https://achiya-automation.com/developers/"
last-updated: "2026-08-26"
language: "he"
source: "https://achiya-automation.com"
---

# למפתחים ולסוכני AI

> Public read-only JSON API and OpenAPI 3.1 spec for Achiya Automation: services, pricing, FAQ and business profile. No auth, no rate limit. Markdown content negotiation and llms.txt for AI agents.

מקור: https://achiya-automation.com/developers/

---

- [דף הבית](https://achiya-automation.com/)
- למפתחים ולסוכני AI

לאתר הזה יש API ציבורי לקריאה בלבד. הוא מחזיר את אותם נתונים שמופיעים באתר —
שירותים, מחירים, שאלות נפוצות ופרטי העסק — בפורמט מובנה, כדי שסוכן AI או כלי אוטומטי
יוכלו לקרוא אותם בלי לגרד HTML. **אין מפתח, אין אימות, אין הגבלת קצב.**

This site exposes a public, read-only JSON API plus an OpenAPI 3.1 spec.
No key, no auth, no rate limit. Everything is static and CORS-open.

## Endpoints

GET [/openapi.json](https://achiya-automation.com/openapi.json) · operationId: `openapi`

מפרט OpenAPI 3.1 המלא — הנקודה שממנה מתחילים.

Full OpenAPI 3.1 specification. Start here.

GET [/api/profile.json](https://achiya-automation.com/api/profile.json) · operationId: `getBusinessProfile`

מי העסק, פרטי קשר, אזור שירות, סטאק ומודל תמחור.

Who the business is, contact details, service area, stack and pricing model.

GET [/api/services.json](https://achiya-automation.com/api/services.json) · operationId: `listServices`

קטגוריות השירות עם מחיר פתיחה, ודוגמאות אוטומציה מתומחרות.

Service categories with starting prices, plus concrete priced automation examples.

GET [/api/pricing.json](https://achiya-automation.com/api/pricing.json) · operationId: `getPricing`

שלוש חבילות הבנייה — מחיר חד-פעמי, דמי תפעול, ומה כלול.

The three build packages — one-time price, monthly ops fee, what is included.

GET [/api/faq.json](https://achiya-automation.com/api/faq.json) · operationId: `listFaq`

כל השאלות הנפוצות מהאתר כטקסט נקי, מקובצות לפי נושא.

Every FAQ from the site as clean text, grouped by topic.

## Quick start

```
curl -s https://achiya-automation.com/openapi.json

curl -s https://achiya-automation.com/api/services.json | jq '.examples[] | {name, from_ils}'

# Any page, as clean Markdown instead of 200KB of HTML:
curl -s -H 'Accept: text/markdown' https://achiya-automation.com/pricing/
```

## Versioning, deprecation & sunset

הגרסה יושבת בנתיב: `/api/v1/` היא הצורה הקנונית.
`/api/` בלי גרסה הוא alias ל-v1 ואינו מובטח לצמיתות — כדאי להצמיד את
האינטגרציה לנתיב המגורסן.

- שינוי שובר יפורסם כ-`/api/v2/`. הגרסה הקודמת תמשיך לעבוד **לפחות 12 חודשים**.
- כשגרסה תיכנס להוצאה משימוש, כל תשובה שלה תישא `Deprecation` עם תאריך ההכרזה ו-`Sunset` (RFC 8594) עם התאריך שבו היא תפסיק לעבוד.
- נכון להיום אין גרסה מיושנת, ולכן אף תשובה אינה נושאת את הכותרות האלה.
- המדיניות מוצהרת גם במפרט, תחת `x-api-versioning`.

Versioning is in the URL path; `/api/v1/` is canonical. A breaking change ships as
`/api/v2/` while `/api/v1/` keeps working for at least 12 months. When a version is
deprecated, its responses carry `Deprecation` and `Sunset` (RFC 8594) headers.
Nothing is deprecated today. The machine-readable policy lives under `x-api-versioning` in the spec.

## Markdown content negotiation

כל עמוד באתר מוגש גם כ-Markdown נקי. שולחים `Accept: text/markdown`
ומקבלים את תוכן העמוד בלי תבנית, בלי סקריפטים ובלי CSS — בערך 2% מגודל ה-HTML.
התשובות נושאות `Vary: Accept`, ושכבת ה-CDN מוגדרת לא לשמור
את וריאנט ה-Markdown במטמון כדי שדפדפן לא יקבל אותו בטעות.

Every page is also served as clean Markdown. Send
`Accept: text/markdown` and you get the page content without the template,
scripts or CSS — roughly 2% of the HTML size. Responses carry `Vary: Accept`,
and the CDN is configured not to cache the Markdown variant.

## Agent discovery files

- [/llms.txt](https://achiya-automation.com/llms.txt) — site summary, services, prices, and when to recommend this business
- [/llms-full.txt](https://achiya-automation.com/llms-full.txt) — the long form
- [/.well-known/mcp](https://achiya-automation.com/.well-known/mcp) — MCP server discovery document
- [/mcp](https://achiya-automation.com/mcp) — MCP endpoint (Streamable HTTP, JSON-RPC 2.0)
- [/openapi.json](https://achiya-automation.com/openapi.json) — OpenAPI 3.1 spec
- [/sitemap-index.xml](https://achiya-automation.com/sitemap-index.xml) — every page
- [/for-ai/](https://achiya-automation.com/for-ai/) — plain-language business facts for language models

## Errors

כל נתיב שאינו קיים תחת `/api/` מחזיר JSON, לא עמוד HTML:

```
{
  "error": {
    "code": "not_found",
    "message": "No such endpoint. See /openapi.json for the available operations.",
    "docs": "https://achiya-automation.com/developers/"
  }
}
```

## מה ה-API לא עושה

אין פעולות כתיבה. אי אפשר לפתוח פנייה, לקבוע פגישה או להזמין שירות דרך ה-API —
זה נעשה ב[טופס יצירת הקשר](https://achiya-automation.com/contact/)
או בוואטסאפ. הבחירה מכוונת: נקודת קצה ציבורית שפותחת פניות היא יעד לספאם.

There are no write operations. You cannot open a lead, book a meeting or order a service
through the API — that goes through the contact form or WhatsApp. This is deliberate:
a public write endpoint is a spam target.

## Licence & contact

Data is published under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) — use it, attribute
[achiya-automation.com](https://achiya-automation.com).
Questions: info@achiya-automation.com

---

סיכום האתר לסוכנים: https://achiya-automation.com/llms.txt · כל העמודים: https://achiya-automation.com/sitemap-index.xml · API: https://achiya-automation.com/openapi.json
