🔌 Developers — Modules & Integrations

Συνδέστε το TenderSense OS με τα δικά σας συστήματα, ή χτίστε modules/plugins που μιλάνε το Action Protocol — όλα από εδώ, χωρίς κώδικα στην πλευρά μας.

1. API Keys — για server-to-server σύνδεση

Φόρτωση…

2. Webhooks — push γεγονότα στο σύστημά σας (HMAC)

Φόρτωση…

3. Modules / Plugins — το δικό σας λογισμικό στο marketplace

Δείτε το marketplace →

Το module σας τρέχει στο δικό σας σύστημα και συνδέεται με το OS μέσω API key (διάβασμα γεγονότων) και webhook (ενημέρωση). Εδώ καταχωρείτε το manifest ώστε να γίνει ορατό στο marketplace — δεν ανεβάζετε κώδικα σε εμάς.

Manifest (JSON)

Φόρτωση…

4. Γρήγορη εκκίνηση

A. Διαβάστε τα γεγονότα του πυρήνα με το κλειδί σας:

curl -H "X-TenderSense-Key: ts_..." \
  "https://tendersense.gr/api/v1/external/events?since_hours=24"

B. Στείλτε feedback που γίνεται typed action:

curl -X POST https://tendersense.gr/api/v1/external/feedback \
  -H "X-TenderSense-Key: ts_..." -H "Content-Type: application/json" \
  -d '{"entity":"PROJECT-123","reason":"...","evidence":["REF-1"]}'

C. Επαλήθευση webhook (Python — replay-safe):

from tendersense_sdk import TenderSenseClient

TenderSenseClient.verify_webhook_request(
    secret, headers, raw_body, max_age_seconds=300)

Πλήρης τεκμηρίωση → OpenAPI 3.1 ↓ Python SDK

5. Πώς φτιάχνω ένα plugin — 3 βήματα

Φτιάξτε API key (πάνω) με read:events — ώστε το plugin σας να διαβάζει τι αλλάζει στον πυρήνα.
Καταχωρήστε webhook στο δικό σας URL — το OS σας ειδοποιεί για τα γεγονότα που επιλέγετε, υπογεγραμμένα με HMAC-SHA256 (timestamp + delivery-id + body).
Ανεβάστε το manifest (πάνω) — με action_protocol_version: "1.0" — και το module σας εμφανίζεται στο marketplace.

Κανόνας ασφάλειας: το OS ποτέ δεν εκτελεί κώδικα τρίτων. Το plugin τρέχει στο σύστημά σας· οι ενέργειες που προτείνει περνούν από το Action Protocol με ανθρώπινη έγκριση.