Ενσωματώσεις (Zapier, Make & άλλα)

Συνδέστε το badges.ninja με τα εργαλεία που ήδη χρησιμοποιείτε — εκδώστε διαπιστευτήρια αυτόματα όταν κάτι συμβαίνει αλλού και αντιδράστε σε πραγματικό χρόνο όταν τα διαπιστευτήρια εκδίδονται, παραδίδονται, ανακαλούνται ή προβάλλονται. Οποιαδήποτε πλατφόρμα μιλά REST και webhooks λειτουργεί· το Zapier και το Make είναι τα ταχύτερα.

Τι Μπορείτε να Αυτοματοποιήσετε

Triggers (badges.ninja → τα εργαλεία σας) — ενεργοποιήστε μια ροή εργασίας όταν:

• ένα διαπιστευτήριο εκδίδεται
• ένα διαπιστευτήριο παραδίδεται (αποστέλλεται το email του)
• ένα διαπιστευτήριο ανακαλείται
• ένα διαπιστευτήριο προβάλλεται για πρώτη φορά

Actions (τα εργαλεία σας → badges.ninja):

• εκδώστε ένα διαπιστευτήριο — απονείμετε ένα έμβλημα σε έναν παραλήπτη

Προαπαιτούμενα

1. Δημιουργήστε ένα κλειδί API στον πίνακα ελέγχου στο API Keys. Χρησιμοποιήστε ένα κλειδί read-write για ενέργειες (έκδοση)· ένα κλειδί read-only είναι εντάξει μόνο για triggers. Δείτε Κλειδιά API.
2. Αυτό ήταν — όλα τρέχουν πάνω από το REST API και τα webhooks.

Zapier

Μόλις συνδεθεί η εφαρμογή badges.ninja στο Zapier:

1. Συνδέστε τον λογαριασμό σας — επικολλήστε το κλειδί API σας όταν σας ζητηθεί.
2. Επιλέξτε ένα trigger (π.χ. Credential Issued) ή την ενέργεια Issue Credential.
3. Αντιστοιχίστε τα πεδία και ενεργοποιήστε το Zap.

Στο παρασκήνιο, τα triggers χρησιμοποιούν το μοντέλο REST Hook του Zapier υποστηριζόμενο από το Webhooks API: το Zapier εγγράφεται μέσω POST /webhooks και το badges.ninja του παραδίδει συμβάντα σε πραγματικό χρόνο, οπότε δεν υπάρχει καθυστέρηση polling.

Make (Integromat) & Προσαρμοσμένες Πλατφόρμες

Δεν απαιτείται εφαρμογή — συνδέστε το απευθείας:

1. Πιστοποιηθείτε με την κεφαλίδα X-Api-Key σε κάθε αίτημα.
2. Εγγραφείτε σε συμβάντα καταχωρώντας το endpoint σας:

   curl -X POST https://api.badges.ninja/webhooks \
     -H "X-Api-Key: bws_your_api_key_here" \
     -H "Content-Type: application/json" \
     -d '{ "url": "https://hook.example.com/badges", "events": ["credential.issued"] }'

3. Λάβετε υπογεγραμμένες παραδόσεις στο endpoint σας. Επαληθεύστε την κεφαλίδα X-Bws-Signature — δείτε Webhooks.
4. Εκδώστε διαπιστευτήρια καλώντας POST /awards — δείτε Awards API.

Αναφορά

• Webhooks API — συμβάντα, ωφέλιμα φορτία, υπογραφές, επαναλήψεις
• Awards API — έκδοση διαπιστευτηρίων
• Κλειδιά API — κλειδιά και εμβέλειες πρόσβασης

Ο πηγαίος κώδικας της εφαρμογής Zapier βρίσκεται στο αποθετήριο στο integrations/zapier/ και μπορεί να προωθηθεί με το Zapier CLI.