Dokumentacja API

    Zasoby i przewodniki dla programistów integrujących się z QR Cake.

    JSON REST APIDynamiczne tworzenie QRAutoryzacja Bearer

    Szybki start

    Interfejs API QR Cake pozwala użytkownikom QR Cake zarządzać kodami QR na koncie.

    Bazowy URL
    https://api.qrcake.com/v1/product

    Uwierzytelnianie

    Utwórz klucz API w panelu i przesyłaj go w nagłówku Authorization.

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

    Zarządzaj kluczami API w sekcji Klucze API.

    Tester żądań API

    Testuj endpointy bezpośrednio z tej strony. Wprowadź klucz API, wybierz endpoint i sprawdź odpowiedź na żywo.

    Interaktywny tester API

    Uruchamiaj żądania bezpośrednio z przeglądarki do wybranego endpointu API QR Cake.

    GET
    Authorization: Bearer <API Key>
    Docelowy URL
    https://api.qrcake.com/v1/product/user/product
    Uruchom żądanie, aby zobaczyć tutaj status i odpowiedź.

    Terminologia

    Produkty

    QR Codes

    Użytkownicy

    Konta QR Cake

    Treść żądań (POST/PUT)

    W przypadku żądań POST i PUT treść musi być zserializowana do ciągu znaków. Jeśli wysyłasz JSON, przekaż go jako ciąg znaków (na przykład JSON.stringify(payload)).

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

    Lista kodów QR

    Zwraca listę kodów QR dostępnych dla klucza API.

    Otwórz w GitBooku
    Ścieżka: /user/product
    URL: https://api.qrcake.com/v1/product/user/product
    Szczegóły żądania
    Nagłówki
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Odpowiedzi
    200 OK
    [
      {
        "accountId": "string",
        "productId": "string",
        "userId": "string",
        "redirect": "string",
        "state": "ACTIVE",
        "metadata": {},
        "createdAt": 0,
        "updatedAt": 0
      }
    ]
    401 Unauthorized
    {
      "message": {}
    }

    Produkty = kody QR.

    GET

    Pobierz kod QR

    Pobiera pojedynczy kod QR.

    Otwórz w GitBooku
    Ścieżka: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Szczegóły żądania
    Parametry ścieżki
    • productId (string)
    Nagłówki
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Odpowiedzi
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }
    POST

    Utwórz kod QR

    Tworzy nowy produkt QR.

    Otwórz w GitBooku
    Ścieżka: /product
    URL: https://api.qrcake.com/v1/product/product
    Szczegóły żądania
    Nagłówki
    • Authorization: Bearer <API Key>
    • Content-Type: application/json
    • Accept: application/json
    Szablon treści
    {
      "redirect": "https://example.com",
      "metadata": {},
      "state": "ACTIVE"
    }
    Odpowiedzi
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }

    Treść żądania POST musi być zserializowana do ciągu znaków (na przykład JSON.stringify(payload)).

    PUT

    Zaktualizuj kod QR

    Aktualizuje istniejący kod QR (produkt).

    Otwórz w GitBooku
    Ścieżka: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Szczegóły żądania
    Parametry ścieżki
    • productId (string)
    Nagłówki
    • Authorization: Bearer <API Key>
    • Content-Type: application/json
    • Accept: application/json
    Szablon treści
    {
      "redirect": "https://example.com",
      "metadata": {},
      "state": "ACTIVE"
    }
    Odpowiedzi
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "expiresAt": 0,
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }

    Treść żądania PUT musi być zserializowana do ciągu znaków.

    DELETE

    Usuń kod QR

    Usuwa kod QR.

    Otwórz w GitBooku
    Ścieżka: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Szczegóły żądania
    Parametry ścieżki
    • productId (string)
    Nagłówki
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Odpowiedzi
    200 OK
    {
      "productId": "string"
    }
    401 Unauthorized
    {
      "message": {}
    }
    GET

    Uprawnienia

    Zwraca uprawnienia przyznane kluczowi API.

    Otwórz w GitBooku
    Ścieżka: /permission
    URL: https://api.qrcake.com/v1/product/permission
    Szczegóły żądania
    Nagłówki
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Odpowiedzi
    200 OK
    {
      "success": true,
      "result": {
        "analytics": true,
        "productLimit": 100,
        "tier": "subscriber",
        "productTotal": 3,
        "productActiveLimit": 100,
        "productActiveTotal": 3
      }
    }
    401 Unauthorized
    {
      "message": {}
    }

    Obsługiwane typy QR

    Używaj tych typów metadanych podczas tworzenia lub aktualizowania produktów QR.

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

    Zacznij od dynamicznych kodów QR i edytowalnych kodów QR na naszej stronie głównej.