FastComments C++ SDK

Χρήση Πιστοποιημένων API (DefaultAPI)

Σημαντικό:

1. Πρέπει να ορίσετε τη βασική διεύθυνση URL (ο δημιουργός cpp‑restsdk δεν τη διαβάζει από το OpenAPI spec)
2. Πρέπει να ορίσετε το κλειδί API σας στο ApiClient πριν κάνετε κλήσεις που απαιτούν πιστοποίηση. Εάν δεν το κάνετε, οι κλήσεις θα αποτύχουν με σφάλμα 401.

#include <iostream>
#include "FastCommentsClient/api/DefaultApi.h"
#include "FastCommentsClient/ApiClient.h"
#include "FastCommentsClient/ApiConfiguration.h"

int main() {
    auto config = std::make_shared<org::openapitools::client::api::ApiConfiguration>();

    // ΑΠΑΙΤΙΤΑΙ: Ορίστε τη βασική διεύθυνση URL (επιλέξτε την περιοχή σας)
    config->setBaseUrl(utility::conversions::to_string_t("https://fastcomments.com"));  // US
    // Ή: config->setBaseUrl(utility::conversions::to_string_t("https://eu.fastcomments.com"));  // EU

    // ΑΠΑΙΤΙΤΑΙ: Ορίστε το κλειδί API σας
    config->setApiKey(utility::conversions::to_string_t("api_key"), utility::conversions::to_string_t("YOUR_API_KEY_HERE"));

    auto apiClient = std::make_shared<org::openapitools::client::api::ApiClient>(config);
    org::openapitools::client::api::DefaultApi api(apiClient);

    // Τώρα κάντε κλήσεις API με πιστοποίηση
    return 0;
}

Χρήση Δημόσιων API (PublicAPI)

Τα δημόσια σημεία τέλους δεν απαιτούν πιστοποίηση:

#include <iostream>
#include "FastCommentsClient/api/PublicApi.h"
#include "FastCommentsClient/ApiClient.h"
#include "FastCommentsClient/ApiConfiguration.h"

int main() {
    auto config = std::make_shared<org::openapitools::client::api::ApiConfiguration>();

    // ΑΠΑΙΤΙΤΑΙ: Ορίστε τη βασική διεύθυνση URL
    config->setBaseUrl(utility::conversions::to_string_t("https://fastcomments.com"));

    auto apiClient = std::make_shared<org::openapitools::client::api::ApiClient>(config);
    org::openapitools::client::api::PublicApi publicApi(apiClient);

    // Κάντε δημόσιες κλήσεις API
    return 0;
}

Χρήση API Συντονισμού (ModerationApi)

Το ModerationApi τροφοδοτεί τον πίνακα ελέγχου του συντονιστή. Κάθε μέθοδος δέχεται μια παράμετρο sso ώστε η κλήση να εκτελείται εκ μέρους ενός συντονιστή που έχει πιστοποιηθεί μέσω SSO (δείτε την ενότητα SSO παρακάτω για το πώς να δημιουργήσετε ένα διακριτικό):

#include <iostream>
#include "FastCommentsClient/api/ModerationApi.h"
#include "FastCommentsClient/ApiClient.h"
#include "FastCommentsClient/ApiConfiguration.h"

int main() {
    auto config = std::make_shared<org::openapitools::client::api::ApiConfiguration>();

    // ΑΠΑΙΤΙΤΑΙ: Ορίστε τη βασική διεύθυνση URL
    config->setBaseUrl(utility::conversions::to_string_t("https://fastcomments.com"));

    auto apiClient = std::make_shared<org::openapitools::client::api::ApiClient>(config);
    org::openapitools::client::api::ModerationApi moderationApi(apiClient);

    // Πραγματοποιήστε κλήση με το SSO διακριτικό του συντονιστή για πιστοποίηση
    auto ssoToken = utility::conversions::to_string_t("YOUR_MODERATOR_SSO_TOKEN");

    org::openapitools::client::api::GetCountOptions options;
    options.sso = ssoToken;

    auto response = moderationApi.getCount(options).get();

    return 0;
}

Κοινά Προβλήματα

1. Σφάλμα “URI must contain a hostname”: Βεβαιωθείτε ότι έχετε καλέσει config->setBaseUrl(utility::conversions::to_string_t("https://fastcomments.com")) πριν δημιουργήσετε το ApiClient. Ο δημιουργός cpp‑restsdk δεν διαβάζει αυτόματα τη διεύθυνση του server από το OpenAPI spec.
2. Σφάλμα 401 “missing‑api‑key”: Βεβαιωθείτε ότι έχετε καλέσει config->setApiKey(utility::conversions::to_string_t("api_key"), utility::conversions::to_string_t("YOUR_KEY")) πριν δημιουργήσετε την περίπτωση DefaultAPI.
3. Λανθασμένη κλάση API: Χρησιμοποιήστε DefaultApi για κλήσεις εξυπηρετητή με πιστοποίηση, PublicApi για κλήσεις πελάτη/δημόσιες, και ModerationApi για κλήσεις πίνακα ελέγχου συντονιστή (πιστοποιημένες με διακριτικό SSO του συντονιστή).

All API methods in this SDK return pplx::task<std::shared_ptr<ResponseType>> from the C++ REST SDK. This gives you flexibility in how you handle API responses.

Συγχρονικές κλήσεις με .get()

Χρησιμοποιήστε το .get() για να μπλοκάρετε το νήμα που καλεί μέχρι να ολοκληρωθεί το αίτημα και να λάβετε το αποτέλεσμα συγχρονικά:

auto config = std::make_shared<org::openapitools::client::api::ApiConfiguration>();
config->setBaseUrl(utility::conversions::to_string_t("https://fastcomments.com"));
config->setApiKey(utility::conversions::to_string_t("api_key"),
                  utility::conversions::to_string_t("YOUR_API_KEY"));

auto apiClient = std::make_shared<org::openapitools::client::api::ApiClient>(config);
org::openapitools::client::api::DefaultApi api(apiClient);

// Required parameters are positional; optional ones go in the options struct
org::openapitools::client::api::GetCommentsOptions options;
options.urlId = utility::conversions::to_string_t("your-url-id");

// Call .get() to block and get the result synchronously
auto response = api.getComments(
    utility::conversions::to_string_t("your-tenant-id"),
    options
).get();  // Μπλοκάρει μέχρι να ολοκληρωθεί το αίτημα HTTP

if (response && response->comments) {
    std::cout << "Found " << response->comments->size() << " comments" << std::endl;
}

Ασύγχρονες κλήσεις με .then()

Χρησιμοποιήστε το .then() για μη-μπλοκαριστική ασύγχρονη εκτέλεση με callbacks:

auto config = std::make_shared<org::openapitools::client::api::ApiConfiguration>();
config->setBaseUrl(utility::conversions::to_string_t("https://fastcomments.com"));
config->setApiKey(utility::conversions::to_string_t("api_key"),
                  utility::conversions::to_string_t("YOUR_API_KEY"));

auto apiClient = std::make_shared<org::openapitools::client::api::ApiClient>(config);
org::openapitools::client::api::DefaultApi api(apiClient);

// Required parameters are positional; optional ones go in the options struct
org::openapitools::client::api::GetCommentsOptions options;
options.urlId = utility::conversions::to_string_t("your-url-id");

// Use .then() for asynchronous callback-based execution
api.getComments(
    utility::conversions::to_string_t("your-tenant-id"),
    options
).then([](std::shared_ptr<GetComments_200_response> response) {
    // Αυτό εκτελείται ασύγχρονα όταν ολοκληρωθεί το αίτημα
    if (response && response->comments) {
        std::cout << "Found " << response->comments->size() << " comments" << std::endl;
    }
});

// Execution continues immediately without blocking
std::cout << "Request sent, continuing..." << std::endl;

Επιλογή μεταξύ Συγχρονισμού και Ασύγχρονης Εκτέλεσης

Η επιλογή εξαρτάται από το περιβάλλον εκτέλεσης και την αρχιτεκτονική της εφαρμογής σας:

.get() (Synchronous blocking)

• Μπλοκάρει το νήμα που καλεί μέχρι να ολοκληρωθεί το αίτημα HTTP
• Απλούστερη ροή κώδικα, πιο εύκολο να λογιστεί κανείς
• Κατάλληλο για αποκλειστικά νήματα εργασίας, επεξεργασία παρτίδων ή εργαλεία γραμμής εντολών
• Μη κατάλληλο για βρόχους γεγονότων, νήματα GUI ή εξυπηρετητές μονής λειτουργίας

.then() (Asynchronous non-blocking)

• Επιστρέφει άμεσα, η callback εκτελείται όταν ολοκληρωθεί το αίτημα
• Δεν μπλοκάρει το νήμα που καλεί
• Απαιτείται για αρχιτεκτονικές βάσει γεγονότων, εφαρμογές GUI ή βρόχους γεγονότων μονής λειτουργίας
• Επιτρέπει την αθροίωση πολλαπλών λειτουργιών
• Πιο σύνθετη ροή ελέγχου

Η σειρά δοκιμών του SDK χρησιμοποιεί αποκλειστικά το .get(), αλλά αυτό είναι κατάλληλο για το περιβάλλον δοκιμών όπου η μπλοκάρισμα είναι αποδεκτή.

Τεκμηρίωση για τα Τελικά Σημεία API

All URIs are relative to https://fastcomments.com

Τεκμηρίωση για Μοντέλα

• APIAuditLog
• APIBanUserChangeLog
• APIBanUserChangedValues
• APIBannedUser
• APIBannedUserWithMultiMatchInfo
• APIComment
• APICommentBase
• APICommentBase_meta
• APICommentCommonBannedUser
• APICreateUserBadgeResponse
• APIDomainConfiguration
• APIEmptyResponse
• APIEmptySuccessResponse
• APIError
• APIGetCommentResponse
• APIGetCommentsResponse
• APIGetUserBadgeProgressListResponse
• APIGetUserBadgeProgressResponse
• APIGetUserBadgeResponse
• APIGetUserBadgesResponse
• APIModerateGetUserBanPreferencesResponse
• APIModerateUserBanPreferences
• APIPage
• APISSOUser
• APISaveCommentResponse
• APIStatus
• APITenant
• APITenantDailyUsage
• APITicket
• APITicketDetail
• APITicketFile
• APIUserSubscription
• AddDomainConfigParams
• AddDomainConfigResponse
• AddDomainConfigResponse_anyOf
• AddPageAPIResponse
• AddSSOUserAPIResponse
• AdjustCommentVotesParams
• AdjustVotesResponse
• AggregateQuestionResultsResponse
• AggregateResponse
• AggregateTimeBucket
• AggregationAPIError
• AggregationItem
• AggregationOpType
• AggregationOperation
• AggregationRequest
• AggregationRequest_sort
• AggregationResponse
• AggregationResponse_stats
• AggregationValue
• AwardUserBadgeResponse
• BanUserFromCommentResult
• BanUserUndoParams
• BannedUserMatch
• BannedUserMatchType
• BannedUserMatch_matchedOnValue
• BillingInfo
• BlockFromCommentParams
• BlockSuccess
• BuildModerationFilterParams
• BuildModerationFilterResponse
• BulkAggregateQuestionItem
• BulkAggregateQuestionResultsRequest
• BulkAggregateQuestionResultsResponse
• BulkCreateHashTagsBody
• [BulkCreateHashTagsBody_tags_inner](https://github.com/FastComments/fastcomments-c