Dokumentacja API
Zasoby i przewodniki dla programistów integrujących się z QR Cake.
Szybki start
Interfejs API QR Cake pozwala użytkownikom QR Cake zarządzać kodami QR na koncie.
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.
Authorization: Bearer <API Key>https://api.qrcake.com/v1/product/user/product
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),
});Lista kodów QR
Zwraca listę kodów QR dostępnych dla klucza API.
Authorization: Bearer <API Key>Accept: application/json
[
{
"accountId": "string",
"productId": "string",
"userId": "string",
"redirect": "string",
"state": "ACTIVE",
"metadata": {},
"createdAt": 0,
"updatedAt": 0
}
]{
"message": {}
}Produkty = kody QR.
Pobierz kod QR
Pobiera pojedynczy kod QR.
- productId (string)
Authorization: Bearer <API Key>Accept: application/json
{
"accountId": "string",
"productId": "string",
"userId": "string",
"redirect": "string",
"state": "ACTIVE",
"metadata": {},
"createdAt": 0,
"updatedAt": 0
}{
"message": {}
}Utwórz kod QR
Tworzy nowy produkt QR.
Authorization: Bearer <API Key>Content-Type: application/jsonAccept: application/json
{
"redirect": "https://example.com",
"metadata": {},
"state": "ACTIVE"
}{
"accountId": "string",
"productId": "string",
"userId": "string",
"redirect": "string",
"state": "ACTIVE",
"metadata": {},
"createdAt": 0,
"updatedAt": 0
}{
"message": {}
}Treść żądania POST musi być zserializowana do ciągu znaków (na przykład JSON.stringify(payload)).
Zaktualizuj kod QR
Aktualizuje istniejący kod QR (produkt).
- productId (string)
Authorization: Bearer <API Key>Content-Type: application/jsonAccept: application/json
{
"redirect": "https://example.com",
"metadata": {},
"state": "ACTIVE"
}{
"accountId": "string",
"productId": "string",
"userId": "string",
"redirect": "string",
"state": "ACTIVE",
"metadata": {},
"expiresAt": 0,
"createdAt": 0,
"updatedAt": 0
}{
"message": {}
}Treść żądania PUT musi być zserializowana do ciągu znaków.
Usuń kod QR
Usuwa kod QR.
- productId (string)
Authorization: Bearer <API Key>Accept: application/json
{
"productId": "string"
}{
"message": {}
}Uprawnienia
Zwraca uprawnienia przyznane kluczowi API.
Authorization: Bearer <API Key>Accept: application/json
{
"success": true,
"result": {
"analytics": true,
"productLimit": 100,
"tier": "subscriber",
"productTotal": 3,
"productActiveLimit": 100,
"productActiveTotal": 3
}
}{
"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.