Μετάβαση στο περιεχόμενο

REST API · v1

REST API της FalconCard

Διαχειριστείτε κάρτες, leads και analytics προγραμματιστικά — για συγχρονισμό CRM, αυτοματισμό και τις δικές σας ενσωματώσεις. Έλεγχος ταυτότητας με Bearer Token, JSON μέσω HTTPS.

01

Ξεκινώντας

Από το token έως το πρώτο επιτυχημένο αίτημά σας σε τρία βήματα. Το API επικοινωνεί αποκλειστικά μέσω JSON πάνω από HTTPS και ακολουθεί τις συνήθεις συμβάσεις REST — αν έχετε ενσωματώσει ποτέ ένα HTTP API, θα νιώσετε αμέσως οικεία.

  1. Δημιουργήστε ένα token

    Ανοίξτε τον πίνακα ελέγχου σας και μεταβείτε στην ενότητα Λογαριασμός → API Tokens. Επιλέξτε τα scopes που χρειάζεται η ενσωμάτωσή σας και αντιγράψτε αμέσως το token — για λόγους ασφαλείας εμφανίζεται σε απλό κείμενο μόνο μία φορά.

    Μετάβαση στα API Tokens
  2. Ορίστε το header Bearer

    Αποστείλετε το token στο header Authorization σε κάθε αίτημα. Προσθέστε Accept: application/json ώστε και τα σφάλματα να επιστρέφονται σε JSON.

    Authorization: Bearer DEIN_API_TOKEN
  3. Αποστείλετε το πρώτο σας αίτημα

    Ανακτήστε τις κάρτες σας. Μια επιτυχημένη κλήση επιστρέφει HTTP 200 με έναν πίνακα data και ένα αντικείμενο meta για τη σελιδοποίηση:

cURL
curl https://falconcard.net/api/v1/cards \
  -H "Authorization: Bearer DEIN_API_TOKEN" \
  -H "Accept: application/json"
Απόκριση · 200 OK
{
  "data": [
    {
      "id": 42,
      "slug": "max-mustermann-a1b2",
      "title": "Max Mustermann",
      "first_name": "Max",
      "last_name": "Mustermann",
      "status": "active",
      "is_public": true,
      "public_url": "https://falconcard.net/c/max-mustermann-a1b2",
      "updated_at": "2026-06-12T10:30:00+00:00"
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 15,
    "total": 1
  }
}

Αν δείτε αυτήν τη μορφή, ο έλεγχος ταυτότητάς σας είναι σωστός. Κάθε endpoint λίστας αποκρίνεται με το ίδιο σχήμα data + meta — οι μεμονωμένοι πόροι επιστρέφονται σε ένα αντικείμενο data χωρίς meta.

Βασικό URL: https://falconcard.net/api/v1 · όλες οι αποκρίσεις είναι σε JSON.

02

Έλεγχος ταυτότητας

Κάθε αίτημα ελέγχεται ως προς την ταυτότητα με προσωπικό token πρόσβασης (Laravel Sanctum) στο header:

Authorization: Bearer DEIN_API_TOKEN

Μπορείτε να δημιουργείτε και να ανακαλείτε tokens ανά πάσα στιγμή στον πίνακα ελέγχου. Κάθε token φέρει ένα ή περισσότερα scopes που περιορίζουν τα δικαιώματά του.

Scopes

cards:read

Προβολή και ανάγνωση καρτών

cards:write

Δημιουργία, ενημέρωση και διαγραφή καρτών

leads:read

Προβολή και ανάγνωση leads

analytics:read

Ανάγνωση analytics προβολών και κλικ

03

Έννοιες

Τέσσερα δομικά στοιχεία που λειτουργούν πανομοιότυπα για κάθε endpoint — μάθετέ τα μία φορά, ισχύουν παντού.

Εκδόσεις

Η τρέχουσα έκδοση είναι η /api/v1 και είναι καρφιτσωμένη στο path. Οι αλλαγές που σπάνε τη συμβατότητα κυκλοφορούν με νέο prefix (π.χ. /api/v2), ώστε οι υπάρχουσες ενσωματώσεις να παραμένουν σταθερές.

Μορφή αιτήματος

Τα endpoints εγγραφής αναμένουν ένα σώμα JSON με Content-Type: application/json. Οι χρονοσφραγίδες είναι σε ISO 8601 (UTC). Τα άγνωστα πεδία αγνοούνται, τα προαιρετικά πεδία που λείπουν παραμένουν αμετάβλητα.

Όριο ρυθμού

Τα Enterprise tokens μπορούν να αποστέλλουν 1000 αιτήματα ανά λεπτό. Κάθε απόκριση φέρει X-RateLimit-Limit και X-RateLimit-Remaining. Σε περίπτωση υπέρβασης λαμβάνετε 429 Too Many Requests με ένα header Retry-After (δευτερόλεπτα έως την επαναφορά) — περιμένετε αυτό το διάστημα πριν επαναλάβετε.

Headers · κάθε απόκριση
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 994

Σελιδοποίηση

Τα endpoints λίστας επιστρέφουν έως 15 στοιχεία ανά σελίδα. Ελέγξτε την με ?page= (με βάση το 1) και ?per_page= (μέγιστο 100). Το αντικείμενο meta αναφέρει current_page, last_page, per_page και total.

meta · κάθε λίστα
"meta": {
  "current_page": 2,
  "last_page": 7,
  "per_page": 15,
  "total": 98
}

Διαθεσιμότητα. Το REST API αποτελεί μέρος του πλάνου Enterprise. Tokens από άλλα πλάνα λαμβάνουν 403.

04

Αναφορά endpoints

Πλήρης αναφορά για όλα τα δέκα endpoints, ομαδοποιημένα ανά πόρο. Κάθε ορισμός παραμένει συγχρονισμένος με την προδιαγραφή OpenAPI — έτοιμη για εισαγωγή σε Postman, Insomnia, Scalar ή στη γεννήτρια κώδικά σας.

01

Cards

Δημιουργία, ανάγνωση, ενημέρωση και διαγραφή ψηφιακών επαγγελματικών καρτών.

GET
/api/v1/cards Scope cards:read

Εμφανίζει τις κάρτες του λογαριασμού, με τις πιο πρόσφατα ενημερωμένες πρώτα.

Παράμετροι

Όνομα Σε Τύπος Υποχρεωτικό Περιγραφή
page query integer όχι Αριθμός σελίδας (με βάση το 1).
per_page query integer όχι Στοιχεία ανά σελίδα, μέγιστο 100.

Απόκριση επιτυχίας

200 OK με έναν πίνακα data καρτών και ένα αντικείμενο meta για τη σελιδοποίηση.

Κωδικοί σφαλμάτων

401403429
POST
/api/v1/cards Scope cards:write

Δημιουργεί μια νέα κάρτα. Το slug και ο τίτλος δημιουργούνται αυτόματα. Τα πεδία που περιορίζονται ανά πλάνο προσαρμόζονται στις επιτρεπόμενες τιμές.

Παράμετροι

Καμία παράμετρος.

Σώμα αιτήματος application/json

Πεδίο Τύπος Περιορισμοί Περιγραφή
first_name Υποχρεωτικό string maxLength 100 Όνομα.
last_name Υποχρεωτικό string maxLength 100 Επώνυμο.
job_title string | null maxLength 150 Θέση / τίτλος εργασίας.
company string | null maxLength 150 Επωνυμία εταιρείας.
bio string | null maxLength 1000 Σύντομη περιγραφή / βιογραφικό.
email string | null email · maxLength 255 Email επικοινωνίας (έγκυρη μορφή email).
phone string | null maxLength 50 Αριθμός τηλεφώνου. Επιτρεπόμενοι χαρακτήρες: ψηφία, κενά και + - ( ) . /
website string | null uri · maxLength 500 URL ιστότοπου.
booking_url string | null uri · maxLength 500 Σύνδεσμος για κράτηση ραντεβού.
video_url string | null uri · maxLength 500 URL βίντεο. Απαιτεί τη λειτουργία προηγμένων analytics, διαφορετικά αγνοείται. περιορισμένο ανά πλάνο
address string | null maxLength 500 Ταχυδρομική διεύθυνση.
social_links array | null maxItems 20 · platform: enum · url: http(s) uri or handle (completed) · maxLength 500 · label: maxLength 100 Λίστα συνδέσμων μέσων κοινωνικής δικτύωσης (πίνακας αντικειμένων).
design_config object | null — Παρακάμψεις σχεδίασης (χρώματα, γραμματοσειρά, διάταξη) ως αντικείμενο.
template_id string | null maxLength 50 ID του προτύπου προς χρήση.
is_public boolean | null default true Αν η κάρτα είναι δημόσια προσβάσιμη. Προεπιλογή true.
show_branding boolean | null — Εμφάνιση επωνυμίας FalconCard. Η απόκρυψή της απαιτεί τη λειτουργία whitelabel, διαφορετικά επιβάλλεται σε true. περιορισμένο ανά πλάνο
show_lead_form boolean | null — Εμφάνιση της φόρμας lead στην κάρτα. Απαιτεί τη λειτουργία φόρμας lead, διαφορετικά επιβάλλεται σε false. περιορισμένο ανά πλάνο
seo_title string | null maxLength 100 Τίτλος SEO για τη δημόσια κάρτα.
seo_description string | null maxLength 250 Meta description για SEO.
language string enum: de en bg cs da el es fr hr hu it nl pl pt ro sk sl sv uk Κύρια γλώσσα της κάρτας (π.χ. de).

Απόκριση επιτυχίας

201 Created με τη νέα κάρτα στο αντικείμενο data μαζί με ένα message.

Κωδικοί σφαλμάτων

401403422429
GET
/api/v1/cards/{card} Scope cards:read

Επιστρέφει μία μεμονωμένη κάρτα μαζί με τα καταγεγραμμένα leads της.

Παράμετροι

Όνομα Σε Τύπος Υποχρεωτικό Περιγραφή
card path integer ναι ID της κάρτας.

Απόκριση επιτυχίας

200 OK με την κάρτα (συμπεριλαμβανομένου ενός ενσωματωμένου πίνακα leads) στο αντικείμενο data.

Κωδικοί σφαλμάτων

401403404429
PUT
/api/v1/cards/{card} Scope cards:write

Ενημερώνει μια κάρτα. Όλα τα πεδία είναι προαιρετικά· αλλάζουν μόνο τα πεδία που παρέχονται. Τα PUT και PATCH συμπεριφέρονται πανομοιότυπα.

Παράμετροι

Όνομα Σε Τύπος Υποχρεωτικό Περιγραφή
card path integer ναι ID της κάρτας.

Σώμα αιτήματος application/json

Πεδίο Τύπος Περιορισμοί Περιγραφή
first_name string maxLength 100 Όνομα.
last_name string maxLength 100 Επώνυμο.
job_title string | null maxLength 150 Θέση / τίτλος εργασίας.
company string | null maxLength 150 Επωνυμία εταιρείας.
bio string | null maxLength 1000 Σύντομη περιγραφή / βιογραφικό.
email string | null email · maxLength 255 Email επικοινωνίας (έγκυρη μορφή email).
phone string | null maxLength 50 Αριθμός τηλεφώνου. Επιτρεπόμενοι χαρακτήρες: ψηφία, κενά και + - ( ) . /
website string | null uri · maxLength 500 URL ιστότοπου.
booking_url string | null uri · maxLength 500 Σύνδεσμος για κράτηση ραντεβού.
video_url string | null uri · maxLength 500 URL βίντεο. Απαιτεί τη λειτουργία προηγμένων analytics, διαφορετικά αγνοείται. περιορισμένο ανά πλάνο
address string | null maxLength 500 Ταχυδρομική διεύθυνση.
social_links array | null maxItems 20 · platform: enum · url: http(s) uri or handle (completed) · maxLength 500 · label: maxLength 100 Λίστα συνδέσμων μέσων κοινωνικής δικτύωσης (πίνακας αντικειμένων).
design_config object | null — Παρακάμψεις σχεδίασης (χρώματα, γραμματοσειρά, διάταξη) ως αντικείμενο.
template_id string | null maxLength 50 ID του προτύπου προς χρήση.
is_public boolean | null — Αν η κάρτα είναι δημόσια προσβάσιμη. Προεπιλογή true.
show_branding boolean | null — Εμφάνιση επωνυμίας FalconCard. Η απόκρυψή της απαιτεί τη λειτουργία whitelabel, διαφορετικά επιβάλλεται σε true. περιορισμένο ανά πλάνο
show_lead_form boolean | null — Εμφάνιση της φόρμας lead στην κάρτα. Απαιτεί τη λειτουργία φόρμας lead, διαφορετικά επιβάλλεται σε false. περιορισμένο ανά πλάνο
seo_title string | null maxLength 100 Τίτλος SEO για τη δημόσια κάρτα.
seo_description string | null maxLength 250 Meta description για SEO.
language string enum: de en bg cs da el es fr hr hu it nl pl pt ro sk sl sv uk Κύρια γλώσσα της κάρτας (π.χ. de).
status string | null enum: active, draft, archived Κατάσταση δημοσίευσης: active, draft ή archived.

Απόκριση επιτυχίας

200 OK με την ενημερωμένη κάρτα στο αντικείμενο data μαζί με ένα message.

Κωδικοί σφαλμάτων

401403404422429
PATCH
/api/v1/cards/{card} Scope cards:write

Ενημερώνει μια κάρτα. Όλα τα πεδία είναι προαιρετικά· αλλάζουν μόνο τα πεδία που παρέχονται. Τα PUT και PATCH συμπεριφέρονται πανομοιότυπα.

Παράμετροι

Όνομα Σε Τύπος Υποχρεωτικό Περιγραφή
card path integer ναι ID της κάρτας.

Σώμα αιτήματος application/json

Πεδίο Τύπος Περιορισμοί Περιγραφή
first_name string maxLength 100 Όνομα.
last_name string maxLength 100 Επώνυμο.
job_title string | null maxLength 150 Θέση / τίτλος εργασίας.
company string | null maxLength 150 Επωνυμία εταιρείας.
bio string | null maxLength 1000 Σύντομη περιγραφή / βιογραφικό.
email string | null email · maxLength 255 Email επικοινωνίας (έγκυρη μορφή email).
phone string | null maxLength 50 Αριθμός τηλεφώνου. Επιτρεπόμενοι χαρακτήρες: ψηφία, κενά και + - ( ) . /
website string | null uri · maxLength 500 URL ιστότοπου.
booking_url string | null uri · maxLength 500 Σύνδεσμος για κράτηση ραντεβού.
video_url string | null uri · maxLength 500 URL βίντεο. Απαιτεί τη λειτουργία προηγμένων analytics, διαφορετικά αγνοείται. περιορισμένο ανά πλάνο
address string | null maxLength 500 Ταχυδρομική διεύθυνση.
social_links array | null maxItems 20 · platform: enum · url: http(s) uri or handle (completed) · maxLength 500 · label: maxLength 100 Λίστα συνδέσμων μέσων κοινωνικής δικτύωσης (πίνακας αντικειμένων).
design_config object | null — Παρακάμψεις σχεδίασης (χρώματα, γραμματοσειρά, διάταξη) ως αντικείμενο.
template_id string | null maxLength 50 ID του προτύπου προς χρήση.
is_public boolean | null — Αν η κάρτα είναι δημόσια προσβάσιμη. Προεπιλογή true.
show_branding boolean | null — Εμφάνιση επωνυμίας FalconCard. Η απόκρυψή της απαιτεί τη λειτουργία whitelabel, διαφορετικά επιβάλλεται σε true. περιορισμένο ανά πλάνο
show_lead_form boolean | null — Εμφάνιση της φόρμας lead στην κάρτα. Απαιτεί τη λειτουργία φόρμας lead, διαφορετικά επιβάλλεται σε false. περιορισμένο ανά πλάνο
seo_title string | null maxLength 100 Τίτλος SEO για τη δημόσια κάρτα.
seo_description string | null maxLength 250 Meta description για SEO.
language string enum: de en bg cs da el es fr hr hu it nl pl pt ro sk sl sv uk Κύρια γλώσσα της κάρτας (π.χ. de).
status string | null enum: active, draft, archived Κατάσταση δημοσίευσης: active, draft ή archived.

Απόκριση επιτυχίας

200 OK με την ενημερωμένη κάρτα στο αντικείμενο data μαζί με ένα message.

Κωδικοί σφαλμάτων

401403404422429
DELETE
/api/v1/cards/{card} Scope cards:write

Διαγράφει οριστικά μια κάρτα.

Παράμετροι

Όνομα Σε Τύπος Υποχρεωτικό Περιγραφή
card path integer ναι ID της κάρτας.

Απόκριση επιτυχίας

200 OK με ένα μήνυμα επιβεβαίωσης.

Κωδικοί σφαλμάτων

401403404429
02

Leads

Ανάγνωση επαφών που καταγράφηκαν μέσω των φορμών leads στις κάρτες σας.

GET
/api/v1/leads Scope leads:read

Εμφανίζει leads που καταγράφηκαν σε όλες τις κάρτες, νεότερα πρώτα. Φιλτράρετε σε μία κάρτα με card_id.

Παράμετροι

Όνομα Σε Τύπος Υποχρεωτικό Περιγραφή
card_id query integer όχι Περιορισμός σε μία μεμονωμένη κάρτα που σας ανήκει.
page query integer όχι Αριθμός σελίδας (με βάση το 1).
per_page query integer όχι Στοιχεία ανά σελίδα, μέγιστο 100.

Απόκριση επιτυχίας

200 OK με έναν πίνακα data leads και ένα αντικείμενο meta.

Κωδικοί σφαλμάτων

401403429
GET
/api/v1/leads/{id} Scope leads:read

Επιστρέφει ένα μεμονωμένο lead με μια συμπαγή αναφορά στην κάρτα καταγραφής.

Παράμετροι

Όνομα Σε Τύπος Υποχρεωτικό Περιγραφή
id path integer ναι ID του lead.

Απόκριση επιτυχίας

200 OK με το lead στο αντικείμενο data.

Κωδικοί σφαλμάτων

401403404429
03

Analytics

Συγκεντρωτικά στατιστικά προβολών και κλικ — για όλες τις κάρτες ή ανά κάρτα.

GET
/api/v1/analytics/views Scope analytics:read

Συγκεντρωτικές μετρήσεις προβολών σε όλες τις κάρτες ή — μέσω του card_id — για μία μεμονωμένη κάρτα.

Παράμετροι

Όνομα Σε Τύπος Υποχρεωτικό Περιγραφή
card_id query integer όχι Περιορισμός σε μία μεμονωμένη κάρτα που σας ανήκει.
period query string (enum) όχι Χρονικό διάστημα αναφοράς. Επιτρέπονται: 7d, 14d, 30d, 90d, 365d. Προεπιλογή 30d.

Απόκριση επιτυχίας

200 OK με total_views, unique_views, views_per_day καθώς και devices, countries και referrers στο αντικείμενο data.

Κωδικοί σφαλμάτων

401403422429
GET
/api/v1/analytics/clicks Scope analytics:read

Συγκεντρωτικές μετρήσεις κλικ σε όλες τις κάρτες ή — μέσω του card_id — για μία μεμονωμένη κάρτα.

Παράμετροι

Όνομα Σε Τύπος Υποχρεωτικό Περιγραφή
card_id query integer όχι Περιορισμός σε μία μεμονωμένη κάρτα που σας ανήκει.
period query string (enum) όχι Χρονικό διάστημα αναφοράς. Επιτρέπονται: 7d, 14d, 30d, 90d, 365d. Προεπιλογή 30d.

Απόκριση επιτυχίας

200 OK με total_clicks, clicks_by_type και clicks_per_day στο αντικείμενο data.

Κωδικοί σφαλμάτων

401403422429

05

Παραδείγματα κώδικα

Έτοιμα αποσπάσματα προς αντιγραφή σε cURL, JavaScript και Python. Αντικαταστήστε το DEIN_API_TOKEN με το πραγματικό σας token.

Προβολή καρτών
curl https://falconcard.net/api/v1/cards?per_page=15 \
  -H "Authorization: Bearer DEIN_API_TOKEN" \
  -H "Accept: application/json"
const res = await fetch("https://falconcard.net/api/v1/cards?per_page=15", {
  headers: {
    Authorization: "Bearer DEIN_API_TOKEN",
    Accept: "application/json",
  },
});
const { data, meta } = await res.json();
console.log(data, meta);
import requests

res = requests.get(
    "https://falconcard.net/api/v1/cards",
    params={"per_page": 15},
    headers={"Authorization": "Bearer DEIN_API_TOKEN"},
)
res.raise_for_status()
payload = res.json()
print(payload["data"], payload["meta"])
Δημιουργία κάρτας
curl -X POST https://falconcard.net/api/v1/cards \
  -H "Authorization: Bearer DEIN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Max",
    "last_name": "Mustermann",
    "job_title": "Geschäftsführer",
    "company": "FalconCard",
    "email": "max@example.com"
  }'
const res = await fetch("https://falconcard.net/api/v1/cards", {
  method: "POST",
  headers: {
    Authorization: "Bearer DEIN_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    first_name: "Max",
    last_name: "Mustermann",
    job_title: "Geschäftsführer",
    company: "FalconCard",
    email: "max@example.com",
  }),
});
const { data, message } = await res.json();
import requests

res = requests.post(
    "https://falconcard.net/api/v1/cards",
    headers={"Authorization": "Bearer DEIN_API_TOKEN"},
    json={
        "first_name": "Max",
        "last_name": "Mustermann",
        "job_title": "Geschäftsführer",
        "company": "FalconCard",
        "email": "max@example.com",
    },
)
res.raise_for_status()
print(res.json()["data"]["id"])
Προβολή leads
curl "https://falconcard.net/api/v1/leads?card_id=42&per_page=50" \
  -H "Authorization: Bearer DEIN_API_TOKEN" \
  -H "Accept: application/json"
const params = new URLSearchParams({ card_id: "42", per_page: "50" });
const res = await fetch(`https://falconcard.net/api/v1/leads?${params}`, {
  headers: {
    Authorization: "Bearer DEIN_API_TOKEN",
    Accept: "application/json",
  },
});
const { data } = await res.json();
import requests

res = requests.get(
    "https://falconcard.net/api/v1/leads",
    params={"card_id": 42, "per_page": 50},
    headers={"Authorization": "Bearer DEIN_API_TOKEN"},
)
res.raise_for_status()
for lead in res.json()["data"]:
    print(lead["name"], lead["email"])
Ανάκτηση analytics
curl "https://falconcard.net/api/v1/analytics/views?card_id=42&period=30d" \
  -H "Authorization: Bearer DEIN_API_TOKEN" \
  -H "Accept: application/json"
const params = new URLSearchParams({ card_id: "42", period: "30d" });
const res = await fetch(`https://falconcard.net/api/v1/analytics/views?${params}`, {
  headers: {
    Authorization: "Bearer DEIN_API_TOKEN",
    Accept: "application/json",
  },
});
const { data } = await res.json();
console.log(data.total_views, data.unique_views);
import requests

res = requests.get(
    "https://falconcard.net/api/v1/analytics/views",
    params={"card_id": 42, "period": "30d"},
    headers={"Authorization": "Bearer DEIN_API_TOKEN"},
)
res.raise_for_status()
stats = res.json()["data"]
print(stats["total_views"], stats["unique_views"])

Παράδειγμα: δημιουργία κάρτας

Αίτημα · cURL
curl -X POST https://falconcard.net/api/v1/cards \
  -H "Authorization: Bearer DEIN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Max",
    "last_name": "Mustermann",
    "job_title": "Geschäftsführer",
    "company": "FalconCard",
    "email": "max@example.com"
  }'
Απόκριση · 201
{
  "data": {
    "id": 42,
    "slug": "max-mustermann-a1b2",
    "title": "Max Mustermann",
    "first_name": "Max",
    "last_name": "Mustermann",
    "status": "active",
    "is_public": true,
    "public_url": "https://falconcard.net/c/max-mustermann-a1b2",
    "created_at": "2026-06-12T10:30:00+00:00"
  },
  "message": "Karte erfolgreich erstellt."
}

06

Σφάλματα

Κάθε σφάλμα επιστρέφει ένα message string. Τα σφάλματα επικύρωσης (422) περιέχουν επιπλέον έναν χάρτη errors.

Status Name Περιγραφή Παράδειγμα σώματος
401 Unauthorized Το token λείπει ή δεν είναι έγκυρο.
{ "message": "Unauthenticated." }
403 Forbidden Το πλάνο δεν περιλαμβάνει πρόσβαση στο API (μόνο Enterprise) ή το token δεν διαθέτει το απαιτούμενο scope.
{
  "message": "API access is not available on your current plan. Please upgrade to Enterprise."
}
404 Not Found Ο πόρος δεν υπάρχει ή δεν ανήκει στον λογαριασμό σας.
{ "message": "Not found." }
422 Unprocessable Entity Η επικύρωση απέτυχε — το σώμα περιέχει έναν χάρτη errors (πεδίο → μηνύματα).
429 Too Many Requests Υπέρβαση ορίου ρυθμού. Το header Retry-After δηλώνει τον χρόνο αναμονής σε δευτερόλεπτα.
{
  "message": "Too Many Requests",
  "retry_after": 37
}

422 περιέχουν επιπλέον έναν χάρτη errors με αντιστοίχιση πεδίου → λίστα μηνυμάτων:

422 Unprocessable Entity
{
  "message": "The last name field is required.",
  "errors": {
    "last_name": ["The last name field is required."],
    "email": ["The email must be a valid email address."]
  }
}

07

Προδιαγραφή αναγνώσιμη από μηχανή

Το πλήρες API τεκμηριώνεται ως OpenAPI 3.1. Κατεβάστε την προδιαγραφή και εισαγάγετέ την σε Postman, Insomnia ή Scalar — ή δημιουργήστε από αυτήν type-safe clients για τη γλώσσα σας.

Συμβατό με Postman · Insomnia · Scalar · γεννήτριες OpenAPI

Λήψη openapi.json

08

Έτοιμοι για ενσωμάτωση;

Εισαγάγετε την προδιαγραφή OpenAPI στα εργαλεία σας ή δημιουργήστε το πρώτο σας API Token απευθείας στον πίνακα ελέγχου.