למפתחים ולסוכני 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 · operationId: openapi

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

Full OpenAPI 3.1 specification. Start here.

GET /api/profile.json · operationId: getBusinessProfile

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

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

GET /api/services.json · operationId: listServices

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

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

GET /api/pricing.json · operationId: getPricing

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

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

GET /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

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 — זה נעשה בטופס יצירת הקשר או בוואטסאפ. הבחירה מכוונת: נקודת קצה ציבורית שפותחת פניות היא יעד לספאם.

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 — use it, attribute achiya-automation.com. Questions: info@achiya-automation.com

נדבר?