Documentazione API
Risorse per sviluppatori e guide per integrare QR Cake.
Avvio rapido
L'API di QR Cake consente agli utenti di QR Cake di gestire i QR code del proprio account.
Autenticazione
Crea una chiave API nella dashboard e inviala nell'header Authorization.
Authorization: Bearer <API Key> Content-Type: application/json
Gestisci le chiavi API in Chiavi API nella dashboard.
Tester richieste API
Testa gli endpoint direttamente da questa pagina. Inserisci la tua chiave API, seleziona un endpoint e controlla la risposta in tempo reale.
Tester API interattivo
Esegui richieste direttamente dal browser verso l'endpoint dell'API di QR Cake selezionato.
Authorization: Bearer <API Key>https://api.qrcake.com/v1/product/user/product
Terminologia
Prodotti
QR code
Utenti
Account QR Cake
Body delle richieste (POST/PUT)
Per le richieste POST e PUT, il body deve essere serializzato come stringa. Se invii JSON, passa una stringa JSON (ad esempio JSON.stringify(payload)).
const payload = { redirect: "https://example.com", metadata: {} };
await fetch(url, {
method: "POST",
body: JSON.stringify(payload),
});Elenca i QR code
Elenca i QR code accessibili con la chiave API.
Authorization: Bearer <API Key>Accept: application/json
[
{
"accountId": "string",
"productId": "string",
"userId": "string",
"redirect": "string",
"state": "ACTIVE",
"metadata": {},
"createdAt": 0,
"updatedAt": 0
}
]{
"message": {}
}Prodotti = QR code.
Ottieni un codice QR
Recupera un QR code.
- 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": {}
}Crea un codice QR
Crea un nuovo prodotto con codice 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": {}
}Il body della richiesta POST deve essere serializzato come stringa (ad esempio JSON.stringify(payload)).
Aggiorna un codice QR
Aggiorna un codice QR esistente (prodotto).
- 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": {}
}Il body della richiesta PUT deve essere serializzato come stringa.
Elimina un codice QR
Elimina un codice QR.
- productId (string)
Authorization: Bearer <API Key>Accept: application/json
{
"productId": "string"
}{
"message": {}
}Autorizzazioni
Restituisce le autorizzazioni concesse alla chiave API.
Authorization: Bearer <API Key>Accept: application/json
{
"success": true,
"result": {
"analytics": true,
"productLimit": 100,
"tier": "subscriber",
"productTotal": 3,
"productActiveLimit": 100,
"productActiveTotal": 3
}
}{
"message": {}
}Tipi di QR supportati
Utilizza questi tipi di metadati durante la creazione o l'aggiornamento di prodotti QR.
redirect, link, image, video, file, pdf, audio, app, event, vCard
Inizia dalla nostra pagina iniziale con QR code dinamici e QR code modificabili.