Κλειδιά API

4 λεπτά ανάγνωσης

Τα κλειδιά API είναι προαιρετικά. Ολοκληρώστε την εγγραφή, τη συνδρομή και τον πρώτο σας agent πριν τα χρειαστείτε.

Είναι προγραμματιστικά διαπιστευτήρια για το Voice Logica API. Κάθε κλειδί περιορίζεται στις λειτουργίες που επιτρέπετε και μπορεί να περιοριστεί σε μία διεύθυνση IP. Το ίδιο κλειδί υπογράφει επίσης MCP clients (ChatGPT, Claude) στον χώρο εργασίας σας.

Ανοίξτε το Team and access από την ομάδα Account στην πλαϊνή στήλη, στη συνέχεια επιλέξτε την καρτέλα API Keys. Αυτή η σελίδα έχει επίσης Members, Pending invitations και Access Requests.

Δημιουργία κλειδιού API

Ανοίξτε τα API Keys και ξεκινήστε ένα νέο κλειδί

Στην καρτέλα API Keys, πατήστε + Api Key.

api-keys-0Expand
Επιλέξτε ένα preset, ονομάστε το κλειδί και ορίστε μια IP αν χρειάζεται

Το drawer Create API key ανοίγει στα δεξιά.
- Preset - ξεκινήστε από πλήρη πρόσβαση (κάθε λειτουργία) ή άλλο preset, στη συνέχεια βελτιώστε παρακάτω.
- API Key Name - χρησιμοποιήστε ένα σαφές όνομα σκοπού όπως CRM Integration, Webhook Handler ή Initiate Call.
- IP Address - προαιρετικό. Αφήστε το κενό για να επιτρέπεται οποιαδήποτε IP. Εισαγάγετε μόνο μια πραγματική διεύθυνση όταν ο καλών έχει σταθερή IP. Μην εισάγετε 0.0.0.0 ως υποκατάστατο για “οποιαδήποτε IP”· το κενό σημαίνει ήδη οποιαδήποτε IP.
api-keys-1Expand
Επιλέξτε τις επιτρεπόμενες λειτουργίες

Στο API operation restrictions, αναπτύξτε κάθε ομάδα και εναλλάξτε τι μπορεί να καλέσει αυτό το κλειδί. Οι ομάδες περιλαμβάνουν Calls, Agents, Workflows, VoIP & SIP, SMS, MCP, Billing, Shopify και Campaigns. Αφήστε τα όλα ενεργά για πλήρη πρόσβαση, ή απενεργοποιήστε αυτά που δεν χρειάζεται το κλειδί.

api-keys-2Expand
Δημιουργήστε το κλειδί και αντιγράψτε το μία φορά

Πατήστε Create API Key. Ο διάλογος Copy your API key εμφανίζει την πλήρη τιμή μόνο αυτή τη μία φορά. Πατήστε Copy, αποθηκεύστε το κλειδί κάπου με ασφάλεια, στη συνέχεια πατήστε Done.

api-keys-3Expand

Διαχείριση των κλειδιών σας

Ο πίνακας απαριθμεί το Name (όνομα), το καλυμμένο Key (κλειδί), το Last Used (τελευταία χρήση) και την ημερομηνία Created (δημιουργίας) κάθε κλειδιού. Χρησιμοποιήστε την αναζήτηση για να βρείτε ένα κλειδί με το όνομα.

Edit (μολύβι) - αλλάξτε το όνομα, τον περιορισμό IP και τις επιτρεπόμενες λειτουργίες. Η ίδια η μυστική τιμή δεν εμφανίζεται ποτέ ξανά και δεν μπορεί να εναλλαγεί επιτόπου.
Revoke (κάδος) - ανοίγει το Revoke API key? Επιβεβαιώστε με Revoke για να αφαιρέσετε οριστικά το κλειδί. Οι εφαρμογές που το χρησιμοποιούν χάνουν αμέσως την πρόσβαση. Δεν υπάρχει ξεχωριστή ενέργεια Delete.

Χρήση του κλειδιού API σας

Πιστοποιήστε τα αιτήματα στέλνοντας το κλειδί στην κεφαλίδα x-api-key:

x-api-key: YOUR_API_KEY

Για παράδειγμα, έναρξη εξερχόμενης κλήσης AI:

curl -X POST https://api.voicelogica.ai/api/v1/phones/calls/initiate-call \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "destinationNumber": "+302101234567",
    "agentId": "your-agent-id",
    "voipPhoneId": "your-voip-phone-id"
  }'

Το destinationNumber είναι υποχρεωτικό· περάστε agentId για εξερχόμενες κλήσεις AI, και είτε voipPhoneId είτε sipTrunkId για να επιλέξετε τη γραμμή από την οποία εξέρχεται η κλήση. Η πλήρης διαδραστική αναφορά για κάθε endpoint βρίσκεται στο api.voicelogica.ai/api-docs.

Αντιμετώπιση προβλημάτων

Τα αιτήματά μου επιστρέφουν 401 Unauthorized

Επιβεβαιώστε ότι το κλειδί αποστέλλεται στην κεφαλίδα x-api-key - όχι ως token Bearer.
Ελέγξτε ότι το κλειδί δεν έχει ανακληθεί από τον πίνακα API Keys.
Αν το κλειδί έχει περιορισμό IP, επαληθεύστε ότι το αίτημα προέρχεται από αυτήν ακριβώς τη διεύθυνση.

Τα αιτήματά μου επιστρέφουν 403 Forbidden

Οι περιορισμοί λειτουργιών του κλειδιού δεν περιλαμβάνουν το endpoint που καλείτε - επεξεργαστείτε το κλειδί και ενεργοποιήστε τη σχετική ομάδα λειτουργιών.

Επόμενα βήματα

Χρειάζεστε βοήθεια;

Αν αντιμετωπίσετε οποιοδήποτε πρόβλημα, η ομάδα υποστήριξης του Voice Logica είναι διαθέσιμη:

support@voicelogica.ai

ΠΡΟΓΡΑΜΜΑΤΙΣΤΕΣ

developers@voicelogica.ai

ΑΝΑΦΟΡΑ API

api.voicelogica.ai/api-docs

Ήταν χρήσιμη αυτή η σελίδα;