Δημόσιο API + SDKs + widget ενσωμάτωσης
Τέσσερα first-party SDKs πάνω από ένα εκδοσιοποιημένο REST API. Cursor pagination, κεφαλίδες Idempotency-Key, υπογραφή webhook με HMAC, βοηθητικά async-iterator, τυποποιημένα σφάλματα. Τα κομμάτια της εμπειρίας προγραμματιστή που πρέπει να υπάρχουν — όχι εκ των υστέρων προσθήκες.
Τα τέσσερα SDKs
@nexbasira/node
Server-side. Τυποποιημένο έναντι του σχήματος OpenAPI· async iterators για σελιδοποιημένες λίστες· constructEvent(body, sig, secret) για επαλήθευση webhook. Μηδενικές εξαρτήσεις χρόνου εκτέλεσης πέρα από το global fetch.
nexbasira (PyPI)
Server-side. Μοντέλα Pydantic v2 παραγόμενα από το σχήμα. Οι sync + async clients μοιράζονται την ίδια επιφάνεια· η επαλήθευση webhook βρίσκεται στο WebhookSigner.verify(body, sig, secret).
@nexbasira/react
Hooks + components για την επιφάνεια χειριστή. Το <CertivisioSessionView /> αποδίδει το UI εντός συνεδρίας με branding, τεκμήρια και συνομιλία. Τοποθετήστε το στην υπάρχουσα εφαρμογή React σας — χωρίς ανακατεύθυνση σε portal.
Widget iframe
<script src=".../nb-embed.js"> + ένα div — η ενσωμάτωση με τη λιγότερη τριβή. Για ομάδες ops που εκτελούν το UI χειριστή από μια στοίβα εκτός React. Το branding κληρονομείται από τη σελίδα ενσωμάτωσης μέσω postMessage.
Χτισμένο πάνω στην προδιαγραφή OpenAPI
Τα SDKs Node + Python παράγονται από το ίδιο φιλτραρισμένο σχήμα OpenAPI 3.1 που δημοσιεύουμε στο app.nexbasira.com/api/public-schema/ — έτσι, αν θέλετε να παρακάμψετε το SDK και να δημιουργήσετε τον δικό σας τυποποιημένο client σε Go ή Rust, μπορείτε:
# Node typed client
npx openapi-typescript https://app.nexbasira.com/api/public-schema/ -o src/nb-types.ts
# Python typed models
datamodel-codegen \
--url https://app.nexbasira.com/api/public-schema/ \
--input-file-type openapi \
--output-model-type pydantic_v2.BaseModel \
--output cvp_models.pyΗ χειρόγραφη εργονομική επιφάνεια (τυποποιημένα σφάλματα, async iterators, επαλήθευση webhook) τοποθετείται πάνω σε αυτούς τους παραγόμενους τύπους. Δεν επιλέγετε ανάμεσα σε «γρήγορο τυποποιημένο client» και «καλή DX» — και τα δύο παρέχονται.
Συμβάσεις REST, βαρετές σκόπιμα
| Σύμβαση | Γιατί |
|---|---|
| Cursor pagination | Σταθερή υπό ταυτόχρονες εγγραφές. next_cursor στην απόκριση· περάστε το πίσω ως ?cursor=…. |
Κεφαλίδα Idempotency-Key | Στείλτε ένα UUID· επαναλάβετε σε timeout· ο διακομιστής επιστρέφει την αρχική απόκριση σε κάθε περίπτωση. |
| Webhooks HMAC-SHA256 | NB-Signature: t=…,v1=…. Τα SDKs παρέχουν επαλήθευση μιας γραμμής· παράθυρο replay 5 λεπτών. |
| Εκδοσιοποιημένο πρόθεμα URL | /api/v1/public/. Οι breaking αλλαγές μετακινούνται στο /v2/ με 12 μήνες επικάλυψης. |
| Διαπιστευτήρια με πύλες scope | Κάθε διαπιστευτήριο φέρει ρητά scopes (sessions:write, evidence:read, …). Εναλλάξτε το χωρίς να χάσετε έναν tenant. |
| Τυποποιημένος φάκελος σφάλματος | Ίδιο σχήμα σε κάθε endpoint. code, detail, retry_after_seconds όταν είναι σχετικό. |
Υπόσχεση σταθερότητας
Οι προσθετικές αλλαγές — νέα προαιρετικά πεδία, νέα endpoints, νέοι τύποι συμβάντων webhook — παρέχονται επιτόπου· τα SDKs αντιμετωπίζουν άγνωστα πεδία ως συμβατά προς τα εμπρός. Οι breaking αλλαγές μετακινούνται σε ένα νέο πρόθεμα URL και επικαλύπτονται με την προηγούμενη έκδοση για τουλάχιστον 12 μήνες. Δεν θα ξυπνήσετε με μια μετεγκατάσταση από πράσινο σε κόκκινο ένα πρωινό Τρίτης.
Ξεκινήστε με τη γρήγορη εκκίνηση
Δημιουργήστε μια συνεδρία, εκδώστε μια πρόσκληση πεδίου, επαληθεύστε ένα webhook — σε λιγότερο από 5 λεπτά. Copy-paste curl + Node + Python στην ίδια σελίδα.