Δημιουργία πρόσκλησης
POSThttps://api.reviewit.gr/v1/invitations
Ταυτοποίηση με το κλειδί API της επιχείρησης (Authorization: Bearer rvk_...), όχι με συνεδρία. Με το κλειδί δοκιμής (rvk_test_...) η απάντηση είναι η ίδια, με test: true, αλλά τίποτα δεν αποθηκεύεται, δεν στέλνεται και δεν μετράει στο όριο.
Στείλτε μόνο το email του πελάτη, το μικρό του όνομα (προαιρετικό) και τον αριθμό παραγγελίας. Το email στέλνεται μετά την καθυστέρηση που έχει ορίσει η επιχείρηση (24 ώρες από προεπιλογή) και η διεύθυνση σβήνεται μόλις σταλεί, το αργότερο σε 30 ημέρες. Η ίδια παραγγελία δεν στέλνεται δύο φορές, οπότε η επανάληψη μιας κλήσης είναι ασφαλής.
Αν η παραγγελία ή ο πελάτης έχει ήδη προσκληθεί (από την ίδια επιχείρηση τις τελευταίες 90 ημέρες), η απάντηση είναι 200 με state: skipped και reason (duplicate, repeat). Δεν στέλνεται τίποτα σε όποιον έχει ζητήσει να μη λαμβάνει προσκλήσεις (από οποιαδήποτε επιχείρηση) ή έχει ήδη γράψει κριτική για την επιχείρηση, αλλά η απάντηση είναι η ίδια 202 με μια κανονική πρόσκληση: δεν λέμε σε καμία επιχείρηση ποιος έχει γράψει κριτική ή έχει διαγραφεί από τη λίστα.
Η επιχείρηση πρέπει να έχει ενεργοποιήσει τις προσκλήσεις και να έχει επιβεβαιώσει ότι ενημερώνει τους πελάτες της (403 invitations_disabled), να έχει πλάνο (403 plan_required) και να μην έχει συμπληρωθεί το μηνιαίο όριο του πλάνου της (429 monthly_limit: Basic 300, Pro 1000, Premium 5000, Enterprise χωρίς όριο).
Παράμετροι
Κεφαλίδες
Authorizationstring απαιτείταιBearer ΤΟ_ΚΛΕΙΔΙ_ΣΑΣΤο κλειδί API της επιχείρησης (rvk_...), που δημιουργεί ο ιδιοκτήτης στη σελίδα «Η επιχείρησή μου»
Content-Typestring απαιτείταιapplication/jsonΤο σώμα του αιτήματος είναι JSON.
Σώμα αιτήματος
emailstringemailαπαιτείταιΤο email του πελάτη
firstNamestringέως 80 χαρακτήρεςΤο μικρό όνομα του πελάτη (προαιρετικό)
orderRefstringέως 100 χαρακτήρεςαπαιτείταιΟ αριθμός παραγγελίας του καταστήματός σας: μία πρόσκληση ανά παραγγελία
Παράδειγμα αιτήματος
curl -X POST https://api.reviewit.gr/v1/invitations \ -H "Authorization: Bearer ΤΟ_ΚΛΕΙΔΙ_ΣΑΣ" \ -H "Content-Type: application/json" \ -d '{"email":"pelatis@example.gr","firstName":"Μαρία","orderRef":"1001"}'<?php$ch = curl_init('https://api.reviewit.gr/v1/invitations');curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer ΤΟ_ΚΛΕΙΔΙ_ΣΑΣ', 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => json_encode([ 'email' => 'pelatis@example.gr', 'firstName' => 'Μαρία', 'orderRef' => '1001', ]),]);$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
echo $status . ' ' . $body;// Node.js 18 or newer(async () => { const res = await fetch('https://api.reviewit.gr/v1/invitations', { method: 'POST', headers: { Authorization: 'Bearer ΤΟ_ΚΛΕΙΔΙ_ΣΑΣ', 'Content-Type': 'application/json', }, body: JSON.stringify({ email: 'pelatis@example.gr', firstName: 'Μαρία', orderRef: '1001', }), signal: AbortSignal.timeout(10_000), });
console.log(res.status, await res.json());})();import requests
res = requests.post( "https://api.reviewit.gr/v1/invitations", headers={"Authorization": "Bearer ΤΟ_ΚΛΕΙΔΙ_ΣΑΣ"}, json={ "email": "pelatis@example.gr", "firstName": "Μαρία", "orderRef": "1001", }, timeout=10,)
print(res.status_code, res.json())// Java 11 or newerimport java.net.URI;import java.net.http.HttpClient;import java.net.http.HttpRequest;import java.net.http.HttpResponse;import java.time.Duration;
public class Invite { public static void main(String[] args) throws Exception { String json = "{\"email\":\"pelatis@example.gr\",\"firstName\":\"Μαρία\",\"orderRef\":\"1001\"}";
HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.reviewit.gr/v1/invitations")) .timeout(Duration.ofSeconds(10)) .header("Authorization", "Bearer ΤΟ_ΚΛΕΙΔΙ_ΣΑΣ") .header("Content-Type", "application/json") .POST(HttpRequest.BodyPublishers.ofString(json)) .build();
HttpResponse<String> response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode() + " " + response.body()); }}package main
import ( "fmt" "io" "net/http" "strings" "time")
func main() { body := `{"email":"pelatis@example.gr","firstName":"Μαρία","orderRef":"1001"}`
req, err := http.NewRequest("POST", "https://api.reviewit.gr/v1/invitations", strings.NewReader(body)) if err != nil { panic(err) } req.Header.Set("Authorization", "Bearer ΤΟ_ΚΛΕΙΔΙ_ΣΑΣ") req.Header.Set("Content-Type", "application/json")
client := &http.Client{Timeout: 10 * time.Second} res, err := client.Do(req) if err != nil { panic(err) } defer res.Body.Close()
out, _ := io.ReadAll(res.Body) fmt.Println(res.StatusCode, string(out))}Αντικαταστήστε το ΤΟ_ΚΛΕΙΔΙ_ΣΑΣ. Ξεκινήστε με το κλειδί δοκιμής: δεν στέλνεται τίποτα.
Απαντήσεις
200
Δεν θα σταλεί τίποτα (skipped): η παραγγελία ή ο πελάτης έχει ήδη προσκληθεί
statestringskippedreasonstringduplicaterepeattestboolean
{ "state": "skipped", "reason": "duplicate"}202
Η πρόσκληση μπήκε στη σειρά για αποστολή
statestringqueuedtestbooleanΜόνο με το κλειδί δοκιμής: δεν μπήκε τίποτα στη σειρά
{ "state": "queued"}401
Λείπει ή είναι λάθος το κλειδί API
403
invitations_disabled ή plan_required
422
Μη έγκυρο πεδίο: validation_failed, με το field και ένα message
errorstringvalidation_failedfieldstringmessagestring
{ "error": "validation_failed", "field": "email", "message": "Μη έγκυρη διεύθυνση email"}429
monthly_limit: συμπληρώθηκε το μηνιαίο όριο του πλάνου
Τι να κάνετε σε κάθε απάντηση: απαντήσεις και σφάλματα.