# Εργασίες για τον πράκτορα

Αυτή η σελίδα γράφτηκε από logs πωλήσεων για 30 ημέρες, όχι από φαντασία. Παρακάτω οι κλήσεις που πραγματικά κάνουν οι ενσωματωτές με κλειδί, με σειρά συχνότητας.

## Τι καλείται συχνότερα

| Ενδοσημείωση | Επιτυχείς κλήσεις σε 30 ημέρες | Γιατί |
|---|---|---|
| `POST /v1/human-design` | 12 563 | βωδιάγραμμα: τύπος, προφίλ, εξουσία, κανάλια |
| `POST /v1/chart` | 11 763 | γέννητη χάρτης: πλανήτες, οίκοι, πτυχές |
| `POST /v1/transits` | 1 999 | μεταβάσεις προς το γέννημα σε ημερομηνία |
| `POST /v1/vedic/dashas/vimshottari/maha` | 1 272 | βεδικοί περίοδοι Βιμσόταρι |
| `POST /v1/houses` | 861 | μόνο κορυφές και γωνίες, χωρίς πλανήτες |
| `POST /v1/planets` | 761 | μόνο θέσεις σωμάτων |
| `POST /v1/acg` | 704 | αστρογραφία, γραμμές στον κόσμο |
| `POST /v1/transit-calendar` | 678 | ημερολόγιο μεταβάσεων για περίοδο |
| `POST /v1/horoscope/daily` | 549 | κείμενο για την ημέρα (AI) |
| `POST /v1/synastry` | 437 | συμβατότητα δύο χαρτών |

`GET /v1/auth/keys/me` (262) είναι επίσης σε αυτή τη λίστα: οι πράκτορες ελέγχουν το κλειδί πριν τη δουλειά. Αυτό είναι δωρεάν και δεν καταναλώνει πιστώσεις.

## Μίνι κλήση

Ένα σώμα λειτουργεί για `chart`, `houses`, `planets`, `human-design`, `transits` και τις υπόλοιπες ενδοσημείωση χαρτιών:

<Code lang="bash" title="terminal" code={`curl -X POST https://api.astroway.info/v1/chart \\
  -H "X-Api-Key: aw_test_YOUR_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{"date":"1990-05-15","time":"15:30:00","timezone":"Europe/Kyiv","latitude":50.45,"longitude":30.52}'`} />

Οι ακριβείς κανόνες πεδίων: [Μορφοποίηση πεδίων](/agent-setup/field-formats/). Το κλειδί `aw_test_*` δεν καταναλώνει πιστώσεις, άρα αξίζει να το χρησιμοποιήσεις για ανάπτυξη.

## Διαβάστε την προδιαγραφή, όχι να μαντεύετε

Κάθε σελίδα λειτουργίας έχει **markdown δίδυμο**: τον ίδιο URL συν `.md`. Αυτό είναι που πρέπει να δίνεις στο μοντέλο αντί για HTML.

<Code lang="bash" title="terminal" code={`curl https://api.astroway.info/docs/api/operations/acg_categories_get.md`} />

Πλησίον: [`/llms.txt`](https://api.astroway.info/llms.txt) ως σημείο εισόδου και [`/v1/openapi.json`](https://api.astroway.info/v1/openapi.json) ως πλήρης προδιαγραφή.

## Όταν το κλειδί δεν χρειάζεται

Χωρίς κλειδί λειτουργούν τρεις χώροι ονομάτων, όλοι με όριο ανά IP: `/v1/public/*` (εννέα υπολογιστικές ενδοσημείωση, που αναφέρονται στη σελίδα [Δωρεάν](/free/)), `/v1/embed/*` (έτοιμα widgets) και `/v1/reference/*` (αναφορές: σημάδια, πλανήτες, πτυχές).

Η απάντηση χωρίς κλειδί περιέχει επιπλέον πεδίο `_footer` με υπογραφή, και αυτό είναι φυσιολογικό, έτσι σημειώνεται το δωρεάν επίπεδο.

## Επόμενο

- [Συχνά λάθη](/agent-setup/mistakes/): τι επιστρέφει συχνότερα 4xx
- [Περισπασμοί](/agent-setup/gotchas/): συμπεριφορά που εκπλήσσει
- [MCP](/agent-setup/): ένας κατάλογος εργαλείων για Claude, Cursor και τους υπόλοιπους