Τεκμηρίωση API

    Πόροι και οδηγοί για προγραμματιστές που θέλουν να ενσωματώσουν το QR Cake.

    JSON REST APIΔημιουργία δυναμικών QRBearer Εξουσιοδότηση

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

    Το API του QR Cake επιτρέπει στους χρήστες του QR Cake να διαχειρίζονται τους QR κωδικούς του λογαριασμού τους.

    Βάση URL
    https://api.qrcake.com/v1/product

    Αυθεντικοποίηση

    Δημιουργήστε ένα κλειδί API από τον πίνακα ελέγχου σας και στείλτε το στην κεφαλίδα Authorization.

    Authorization: Bearer <API Key>
    Content-Type: application/json

    Διαχείριση API κλειδιών σε Κλειδιά API στον πίνακα ελέγχου.

    Δοκιμαστής αιτημάτων API

    Δοκιμάστε τελικά σημεία απευθείας από αυτή τη σελίδα. Εισαγάγετε το κλειδί API, επιλέξτε τελικό σημείο και ελέγξτε τη ζωντανή απόκριση.

    Διαδραστικός δοκιμαστής API

    Εκτελέστε αιτήματα απευθείας από το πρόγραμμα περιήγησής σας προς το επιλεγμένο endpoint του API του QR Cake.

    GET
    Authorization: Bearer <API Key>
    Επιλυμένο URL
    https://api.qrcake.com/v1/product/user/product
    Εκτελέστε ένα αίτημα για να δείτε τη ζωντανή κατάσταση και την έξοδο απόκρισης εδώ.

    Ορολογία

    Προϊόντα

    QR κωδικοί

    Χρήστες

    Λογαριασμοί QR Cake

    Σώματα αιτήματος (POST/PUT)

    Για αιτήματα POST και PUT, τα σώματα πρέπει να αποστέλλονται ως string. Αν στέλνετε JSON, περάστε μια JSON συμβολοσειρά (για παράδειγμα JSON.stringify(payload)).

    const payload = { redirect: "https://example.com", metadata: {} };
    
    await fetch(url, {
      method: "POST",
      body: JSON.stringify(payload),
    });
    GET

    Λίστα QR κωδίκων

    Επιστρέφει τους QR κωδικούς που είναι προσβάσιμοι από το κλειδί API.

    Άνοιγμα στο GitBook
    Μονοπάτι: /user/product
    URL: https://api.qrcake.com/v1/product/user/product
    Στοιχεία αιτήματος
    Κεφαλίδες
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Απαντήσεις
    200 OK
    [
      {
        "accountId": "string",
        "productId": "string",
        "userId": "string",
        "redirect": "string",
        "state": "ACTIVE",
        "metadata": {},
        "createdAt": 0,
        "updatedAt": 0
      }
    ]
    401 Unauthorized
    {
      "message": {}
    }

    Products = QR κωδικοί.

    GET

    Λήψη QR κωδικού

    Επιστρέφει έναν QR κώδικα.

    Άνοιγμα στο GitBook
    Μονοπάτι: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Στοιχεία αιτήματος
    Παράμετροι διαδρομής
    • productId (string)
    Κεφαλίδες
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Απαντήσεις
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }
    POST

    Δημιουργία QR κωδικού

    Δημιουργεί ένα νέο QR προϊόν.

    Άνοιγμα στο GitBook
    Μονοπάτι: /product
    URL: https://api.qrcake.com/v1/product/product
    Στοιχεία αιτήματος
    Κεφαλίδες
    • Authorization: Bearer <API Key>
    • Content-Type: application/json
    • Accept: application/json
    Πρότυπο σώματος
    {
      "redirect": "https://example.com",
      "metadata": {},
      "state": "ACTIVE"
    }
    Απαντήσεις
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }

    Το σώμα του POST αιτήματος πρέπει να σταλεί ως string (για παράδειγμα, JSON.stringify(payload)).

    PUT

    Ενημέρωση QR κωδικού

    Ενημερώνει έναν υπάρχοντα QR κώδικα (product).

    Άνοιγμα στο GitBook
    Μονοπάτι: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Στοιχεία αιτήματος
    Παράμετροι διαδρομής
    • productId (string)
    Κεφαλίδες
    • Authorization: Bearer <API Key>
    • Content-Type: application/json
    • Accept: application/json
    Πρότυπο σώματος
    {
      "redirect": "https://example.com",
      "metadata": {},
      "state": "ACTIVE"
    }
    Απαντήσεις
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "expiresAt": 0,
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }

    Το σώμα του PUT αιτήματος πρέπει να σταλεί ως string.

    DELETE

    Διαγραφή QR κωδικού

    Διαγράφει έναν QR κώδικα.

    Άνοιγμα στο GitBook
    Μονοπάτι: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Στοιχεία αιτήματος
    Παράμετροι διαδρομής
    • productId (string)
    Κεφαλίδες
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Απαντήσεις
    200 OK
    {
      "productId": "string"
    }
    401 Unauthorized
    {
      "message": {}
    }
    GET

    Άδειες

    Επιστρέφει τα δικαιώματα που έχουν εκχωρηθεί στο κλειδί API.

    Άνοιγμα στο GitBook
    Μονοπάτι: /permission
    URL: https://api.qrcake.com/v1/product/permission
    Στοιχεία αιτήματος
    Κεφαλίδες
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Απαντήσεις
    200 OK
    {
      "success": true,
      "result": {
        "analytics": true,
        "productLimit": 100,
        "tier": "subscriber",
        "productTotal": 3,
        "productActiveLimit": 100,
        "productActiveTotal": 3
      }
    }
    401 Unauthorized
    {
      "message": {}
    }

    Υποστηριζόμενοι τύποι QR

    Χρησιμοποιήστε αυτούς τους τύπους μεταδεδομένων όταν δημιουργείτε ή ενημερώνετε QR προϊόντα.

    redirect, link, image, video, file, pdf, audio, app, event, vCard

    Ξεκινήστε από την αρχική μας σελίδα με τους δυναμικούς QR κωδικούς και τους επεξεργάσιμους QR κωδικούς.