Documentation
Get up and running in minutes.
A short path from integration to your first reputation summary.
Connect
Point your app at the API and authenticate with your environment key.
Publish
Create a subject, add a verification context, then post a review.
Read
Fetch the reputation summary through REST or GraphQL.
Core Endpoints
GET /api/subjects/{id}POST /api/reviewsGET /api/reputation/{type}/{id}POST /graphql
Security
Keep your API key server-side and let the client handle the read flow. Use short-lived tokens for client-side visibility.
Adding a Review
Choose your preferred method to ingest verified reviews into the platform.
1. SDK
The strongly-typed C# client is the easiest way to interact with the platform from any .NET application.
var client = new ReputationManagementPlatformClient(httpClient);
var review = await client.CreateReviewAsync(new CreateReviewRequest
{
SubjectId = Guid.Parse("..."),
ReviewerId = Guid.Parse("..."),
TrustTier = TrustTier.Verified,
Rating = 5,
Title = "Excellent Quality",
Body = "The product exceeded my expectations.",
Tags = ["Quality", "Fast Shipping"]
});2. REST API
Integrate from any language using our standard REST endpoints. Authenticate using the X-API-Key header.
curl -X POST https://api.saascade.com/api/reviews \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key_here" \
-d '{
"subjectId": "018e9a2b-...",
"reviewerId": "018e9a2c-...",
"trustTier": "Verified",
"rating": 5,
"title": "Excellent Quality",
"body": "The product exceeded my expectations.",
"tags": ["Quality", "Fast Shipping"]
}'3. GraphQL API
Use GraphQL to submit reviews and request the exact response shape you need in a single round-trip.
mutation CreateReview($input: CreateReviewInput!) {
createReview(input: $input) {
review {
id
moderationState
createdAt
}
}
}
# Variables
{
"input": {
"subjectId": "018e9a2b-...",
"reviewerId": "018e9a2c-...",
"trustTier": "VERIFIED",
"rating": 5,
"title": "Excellent Quality",
"body": "The product exceeded my expectations.",
"tags": ["Quality", "Fast Shipping"]
}
}Retrieving Reviews
Fetch the reputation summary or raw reviews using any protocol.
1. SDK
Query reviews quickly using the strongly-typed C# client.
var client = new ReputationManagementPlatformClient(httpClient);
var reviews = await client.GetReviewsAsync(
subjectId: Guid.Parse("018e9a2b-..."),
trustTier: TrustTier.Verified
);
foreach (var review in reviews)
{
Console.WriteLine($"{review.Rating} stars: {review.Title}");
}2. REST API
Standard GET requests work flawlessly from anywhere. Pass parameters as query strings.
curl -X GET "https://api.saascade.com/api/reviews?subjectId=018e9a2b-...&trustTier=Verified" \
-H "X-API-Key: your_api_key_here"3. GraphQL API
Query exactly the fields you want to minimize payload size and improve performance.
query GetReviews($subjectId: Uuid!) {
reviews(where: { subjectId: { eq: $subjectId } }) {
nodes {
id
rating
title
body
createdAt
}
}
}
# Variables
{
"subjectId": "018e9a2b-..."
}