Προγραμματιστής πλατφόρμας · Γενικά API · webhooks · connectors

Κάντε την πλατφόρμα σας Λειτουργεί με AI.

Καλέστε 2,430 ονομασμένες λειτουργίες μέσω ενός ενιαίου API που παράγεται από το συμβόλαιο, με πεδία ελάχιστων δικαιωμάτων, δέσμευση στον χώρο εργασίας, επικύρωση δοκιμαστικής εκτέλεσης και εγγραφές ασφαλείς για επανάληψη. Εγγραφείτε σε κανονικά συμβάντα μέσω webhooks παρασκηνίου υπογεγραμμένων με HMAC ή δημιουργήστε ένα διαχειριζόμενο πακέτο στο Connector Builder έξι βημάτων.

Πάρτε ένα API κλειδί Διαβάστε τα έγγραφα Σύμβαση OpenAPI

Κλειδιά Bearer με εμβέλειαΕνέργειες συμβολαίου: 2,430OpenAPI 3.0.3 + _PostmanΠαράδοση webhook HMAC

Αίτημα σε εξέλιξη

Υπογραφή webhook out → 200 Εντάξει.

Ζωντανά

2,430με το όνομα Στρατηγός API δράσεις

69λιγότερο από τα όρια του περιβάλλοντος

dry_runεπικύρωση συμβάσεων εγγραφής πριν από την εκτέλεση

24hεπιτυχής επανάληψη idempotent-write

Ο κύκλος ζωής του αιτήματος

Εισερχόμενη κλήση με εμβέλεια. Υπογεγραμμένο γεγονός.

POST μια ενέργεια για /api/v1.php με το radided Bearer κλειδί. OpsIQ pins ο χώρος εργασίας, επικυρώνει τη σύμβαση δράσης και τις άδειες, στη συνέχεια εκτελεί ή ξηρό-runs αυτό. Συνδρομημένα κανονικά γεγονότα αφήνουν μέσα από μια HMAC-υπογεγραμμένη ουρά παράδοσης με ανιχνεύσιμες προσπάθειες και οριοθετημένες επαναλήψεις.

HMAC-SHA256 webhooks (στα Αγγλικά) - τα εισερχόμενα και εξερχόμενο ωφέλιμα φορτία υπογράφονται πάνω από το ακατέργαστο σώμα; API Οι κλήσεις ελέγχουν την ταυτότητα με ένα πεδίο εφαρμογής. Bearer Το κλειδί.

Αυτόματες επαναφορτίσεις - απέτυχε παραδόσεις πίσω μακριά και να προσπαθήσουμε, με μια ταυτότητα παράδοσης μπορείτε να εντοπίσετε.

Εγγραφή με ασφάλεια αναπαραγωγής - επιτυχής idempoent γράφει επιστρέφει την ίδια απάντηση για 24 ώρες· ταυτόχρονα αντίγραφα μοιράζονται μία αξίωση.

01 Bearer αίτημα 02 χώρος εργασίας καρφιτσών 03 επικύρωση της σύμβασης 04 εκτέλεση ή εκτέλεση σε ξηρή κατάσταση 05 event υπογεγραμμένο από την ουρά

Γρήγορη εκκίνηση

Από το κλειδί στην ενσωμάτωση των κυβερνήσεων τρία βήματα.

Εκδίδετε ένα λιγότερο-κλειδί privilege, ανακαλύπτετε το δημιουργημένο συμβόλαιο, εκτελέστε μια εγγραφή, στη συνέχεια εγγραφείτε σε ένα webhook όταν η εφαρμογή σας χρειάζεται παράδοση γεγονότων φόντου.

Κονσόλα σύμβασηςΣυνδεδεμένο

Εκτέλεσηdry_run → εγκεκριμένη εγγραφή, ίδια σύμβαση

Πάρε ένα κλειδί.

Εγγραφείτε και δημιουργήστε ένα λογαριασμό. Bearer API κλειδί (opq_…) στις ρυθμίσεις του προγραμματιστή και δίνουν σε κάθε ολοκλήρωση μόνο τις επιφάνειες που χρειάζεται.

Ανακαλύψτε & επικυρώστε

Ανάγνωση meta.actions, meta.action και meta.scopes· χρήση dry_run να επικυρώσει τις γραφές πριν την εκτέλεση.

Εκτέλεση & εγγραφής

Προσθέστε ένα κλειδί idempotency για τις εγγραφές, στη συνέχεια εγγραφείτε το τελικό σημείο σας στα κανονικά γεγονότα που χρειάζεται η εφαρμογή σας.

Πως ταιριάζει μεταξύ τους

Ένα μοτίβο σύνδεσης. Πέντε καθαροί πρωτόγονοι.

Οτιδήποτε είναι ειδικό για μια πλατφόρμα βρίσκεται σε μια διασύνδεση. Ο πυρήνας του OpsIQ παραμένει γενικός, η AI παραμένει προβλέψιμη και η ενσωμάτωσή σας παραμένει ελέγξιμη.

Ενεργοποιητές

Πες το. OpsIQ Τι συνέβη μόλις τώρα.

Οι συνδρομητές λαμβάνουν το γεγονός μέσω των καταχωρημένων κανόνων προτεραιότητας και παράδοσης.

Αναφορά γεγονότος

Καθολικές + προσαρμοσμένες εκδηλώσειςinvoice.paid, ticket.created, subscription.cancelled, customer.signed_up Ή το δικό σου. Συνδρομητές Fan-outΟ εγκέφαλος της τεχνητής νοημοσύνης, οι κανόνες αυτοματοποίησης, οι σύνδεσμοι καθρεφτών και τα τελικά σημεία webhook σας όλα αντιδρούν. Σειρά προτεραιότηταςΑποφασιστική αποστολή έτσι καθρέφτες γράφουν πριν ειδοποιήσει φωτιά.

02 / Συμβάσεις δράσης

Πες το. OpsIQ Τι επιτρέπεται να κάνει η τεχνητή νοημοσύνη.

Κάθε επιχείρηση που ονομάζεται λαμβάνει μια παραγόμενη σύμβαση: πεδίο εφαρμογής, χαρακτηριστικό, διαβασμένο ή γράψε είδος, κίνδυνο, πολιτική επιβεβαίωσης, το σχήμα αίτησης και απάντησης, υποστήριξη σε ξηρό, ιδεοδυναμία και σταθερά λάθη.

Σχήμα δράσης

Η τεχνητή νοημοσύνη δεν μπορεί να εφεύρει πράξεις.Μπορεί να ζητήσει μόνο να τρέξει αυτά που έχετε καταχωρήσει. Πολιτική επιβεβαίωσηςΟι επικίνδυνες ενέργειες ενεργοποιούν μια κάρτα προεπισκόπησης πριν από οποιαδήποτε παρενέργεια. Ρόλος + επιφανειακό επίστρωμαΚάθε ενέργεια δηλώνει τους ρόλους και τις επιφάνειες που επιτρέπεται να το εκτελέσουν.

δημιουργούμενη σύμβαση δράσης · JSON

{
  "action": "tickets.reply",
  "kind": "write",
  "scopes": ["tickets.write", "admin"],
  "feature": "ticket_system",
  "risk": "medium",
  "confirmation": "recommended",
  "idempotency": "supported",
  "dry_run": true,
  "request": { "type": "object" },
  "response": { "required": ["success"] }
}

03 / Υπογεγραμμένα webhooks

Σπρώξτε τα γεγονότα στο σωρό σας - με κρυπτογραφική απόδειξη.

Εγγραφείτε με οποιοδήποτε URL σε οποιοδήποτε από τα 53 παραδοτέα συμβάντα. Το OpsIQ στέλνει το φορτίο JSON με POST, υπογεγραμμένο με HMAC-SHA256 πάνω στην έκδοση σχήματος, τη χρονοσφραγίδα, το αναγνωριστικό παράδοσης και το σώμα μαζί, όχι μόνο το σώμα, ώστε η χθεσινή παράδοση να μην μπορεί να αναπαραχθεί εναντίον σας σήμερα.

Προστασία επανάληψηςΑναγνωριστικό παράδοσηςΕπαναλήψεις με καθυστέρηση σε 5 βήματα

Αναφορά webhook

επαλήθευση webhook - php

$raw = file_get_contents('php://input');
$sig = $_SERVER['HTTP_X_OPSIQ_SIGNATURE'] ?? '';   // "v2=<hex>"
$ts  = (int)($_SERVER['HTTP_X_OPSIQ_TIMESTAMP'] ?? 0);
$id  = (int)($_SERVER['HTTP_X_OPSIQ_DELIVERY'] ?? 0);

if (abs(time() - $ts) > 300) http_response_code(401);   // replay window
[$ver, $hex] = array_pad(explode('=', $sig, 2), 2, '');  // split the prefix

$signed   = $ver . '.' . $ts . '.' . $id . '.' . $raw;   // NOT the body alone
$expected = hash_hmac('sha256', $signed, $secret);
if (!hash_equals($expected, $hex)) http_response_code(401);

$event = json_decode($raw, true);   // $id is stable across retries

04/ SDKs

Χρησιμοποιήστε απευθείας HTTP ή να δημιουργήσετε τον πελάτη που προτιμάτε.

Το πλήρες General API δημοσιεύεται ως OpenAPI 3.0.3 και Postman. Οι αποστολείς αναφοράς PHP και οι πελάτες ενσωμάτωσης Node και Python καλύπτουν ροές υπογεγραμμένων συμβάντων και webhook· οποιαδήποτε στοίβα μπορεί να καλέσει απευθείας την ίδια επιφάνεια ενεργειών JSON.

παραδείγματα πελατών

const response = await fetch(`${base}/api/v1.php`, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.OPSIQ_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    action: "tickets.reply",
    dry_run: true,
    idempotency_key: crypto.randomUUID(),
    body: "Thanks. We are checking this now."
  })
});

$payload = json_encode([
  'action' => 'tickets.reply',
  'dry_run' => true,
  'idempotency_key' => bin2hex(random_bytes(16)),
  'body' => 'Thanks - we are checking this now.',
]);

$ch = curl_init($base . '/api/v1.php');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => $payload,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('OPSIQ_KEY'),
    'Content-Type: application/json',
  ],
]);

response = requests.post(
    f"{base}/api/v1.php",
    headers={
        "Authorization": f"Bearer {os.environ['OPSIQ_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "action": "tickets.reply",
        "dry_run": True,
        "idempotency_key": str(uuid.uuid4()),
        "body": "Thanks - we are checking this now.",
    },
)

Άμεση JSON HTTP (HtTP)OpenAPI 3.0.3_Postman συλλογήΒοηθήματα ενσωμάτωσης

05 / Το μοτίβο σύνδεσης

Φτιάξε μια φορά, σύνδεσε τα πάντα.

Μια διασύνδεση είναι ένα ελεγχόμενο πακέτο που δημιουργείται ή εισάγεται μέσω των βημάτων Ταυτότητα, Πιστοποίηση, Δοκιμή, Ενέργειες, Εναύσματα και Έλεγχος. Το manifest της δηλώνει τις επιφάνειες δυνατοτήτων που επιτρέπεται να εκθέσει το OpsIQ.

Ανοίξτε το έξι-στάδιο Builder

Έξι καθοδηγούμενα στάδιαΤαυτότητα, Αυθ, δοκιμή, ενέργειες, ενεργοποιητές και κριτική διατηρούν τη δημιουργία πακέτου εξηγήσιμη. Με βάση τη σύμβασηΤα προφίλ (8) και οι τύποι δυνατοτήτων (59) δηλώνουν τις επιφάνειες που υλοποιεί ένα πακέτο. ΑποδεσμεύεταιΗ ασφάλεια, η προέλευση και η συμμόρφωση διενεργούνται πριν από την επεξεργασία ενός πακέτου ως έτοιμο.

Από πρόθεση σε ασφαλή δράση

Απλά αγγλικά μέσα. Η ελεγκτική επιχείρηση τελείωσε.

OpsIQ δεν εφευρίσκει ποτέ τη σωστή κλήση. Περπατά μέσα από τα καταχωρημένα συμβόλαια, προετοιμάζει το ωφέλιμο φορτίο, ζητά επιβεβαίωση όταν η ενέργεια το απαιτεί, και παράγει μια πλήρη σειρά ελέγχου όταν εκτελεί, έτσι ώστε μια AI που μπορεί να πράξη Ποτέ δεν γίνεται μια Αλ που δεν μπορείς να εμπιστευτείς.

Δεσμευμένο από σύμβαση. Η τεχνητή νοημοσύνη προτείνει μόνο τις ενέργειες που έχετε καταχωρήσει.

Επιβεβαιώστε πριν τις παρενέργειες. Οι επικίνδυνες ενέργειες εμφανίζονται πρώτα σε μια κάρτα προεπισκόπησης.

Πλήρης ανάκληση. Κάθε άμεση, αντίδραση και δράση έχει ως αποτέλεσμα την AI History.

Δείτε το σχήμα δράσης

4 βήματαπρόθεση → έλεγχος

HMAC (ΗΠΑΚ)υπογεγραμμένη πριν από την εκτέλεση

Δεν επινοήθηκαν κλήσεις.μόνο μητρώο σύμβασης

Επιβεβαιώνεται η πύληπροεπισκόπηση πριν από τις παρενέργειες

Αιτούμαι ιχνογράφησηςηθοποιός + συμβόλαιο + αποτέλεσμα

Βάση

API επιφάνεια Με μια ματιά.

Μία επιφάνεια JSON POST εκθέτει 2,430 ονομασμένες ενέργειες. Κάθε παραγόμενη σύμβαση δηλώνει πεδία ταυτοποίησης, τύπο ανάγνωσης/εγγραφής, κίνδυνο, επιβεβαίωση, σχήμα αιτήματος, δοκιμαστική εκτέλεση, ιδιοδυναμία και σταθερά σφάλματα.

OpenAPI 3.0.3 παραπομπή

ΔράσηΑυθΑσφάλεια εγγραφήςΌριο

Εγγραφή ενεργειώνΠΟΣΤΟ /api/v1.php · επικυρωμένο συμβόλαιο

ACTION tickets.replytickets.writeξηρή_ εκτέλεση + ιδεαδυναμίαΔιαμορφωμένος/ώρα

ACTION security.reportsecurity.writeξηρή_ εκτέλεση + ιδεαδυναμίαΔιαμορφωμένος/ώρα

ACTION platform.routes.writeτο adminεπιβεβαίωση + κλειδίΔιαμορφωμένος/ώρα

Αναγνώριση & ενεργειώνΊδια επιφάνεια POST · σταθεροί φάκελοι

ACTION meta.actionsΔημόσια ανακάλυψηΜόνο για ανάγνωσηΔιαμορφωμένος/ώρα

ACTION tickets.listtickets.readΜόνο για ανάγνωσηΔιαμορφωμένος/ώρα

ACTION connectors.listconnectors.readΜόνο για ανάγνωσηΔιαμορφωμένος/ώρα

Δράσεις PeopleOS HRΘεραπευμένη hr.* συμβάσεις · hr.read / hr.write Περιβλήματα

ACTION hr.people.listhr.readΜόνο για ανάγνωσηΔιαμορφωμένος/ώρα

ACTION hr.people.createhr.writeξηρή_ εκτέλεση + ιδεαδυναμίαΔιαμορφωμένος/ώρα

ACTION hr.org.treehr.readΜόνο για ανάγνωσηΔιαμορφωμένος/ώρα

Το PeopleOS HR δεν στέλνει outbound HR webhook events. Φτάσε το μέσω της ίδιας επιφάνειας POST, ή εγγραφείς στα γεγονότα που δημοσιεύουν άλλες ενότητες. Πλήρης αναφορά: API και διασυνδέσεις PeopleOS και η Τμήμα PeopleOS της αναφοράς του προγραμματιστήΗ μονάδα είναι φραγμένη, οπότε ένα κλειδί χωρίς hr παίρνει μια άρνηση, όχι μια άδεια λίστα. Τι είναι το PeopleOS HR.

Τα όρια τιμών ρυθμίζονται ανά πλήκτρο σε ένα ωριαίο παράθυρο. X-RateLimit-Limit, X-RateLimit-Remaining και X-RateLimit-Reset· απόρριψη των αποδόσεων της αίτησης 429 με Retry-After. Χρησιμοποιήστε τη Σύμβαση OpenAPI 3.0.3 ή Postman συλλογή που παράγονται από τα ίδια μητρώα χρόνου εκτέλεσης.

Δημιουργία διασύνδεσης

Κατασκευή, δοκιμή και απελευθέρωση έξι στάδια.

Ξεκινήστε από ένα κυβερνώμενο προφίλ ή ορίστε ο ίδιος τη σύμβαση. Ο Οικοδόμος επικυρώνει κάθε στάδιο πριν δημιουργήσει ένα αυτοτελές πακέτο σύνδεσης.

1Ταυτότητα. Όνομα, γυμνοσάλιαγκας, προφίλ και δηλωμένες επιφάνειες ικανότητας.

2Ωθ. API Κλειδί, Bearer, Basic, OAuth 2.0, HMAC ή ένας προσαρμοσμένος πελάτης.

3Δοκιμή. Επικύρωση των ρυθμίσεων σύνδεσης πριν από τη συσκευασία.

4Ενέργειες. Χάρτης με ονομασία λειτουργίες, παράμετροι, πεδία και κίνδυνος.

5Εναύσματα. Δηλώστε εισερχόμενα γεγονότα, webhooks, δημοσκόπηση και συγχρονισμό συμπεριφοράς.

6Επανεξέταση. Ελέγξτε το συμβόλαιο και περάστε την πύλη απελευθέρωσης.

Δοκιμή πριν από το πλοίο

Επιβεβαιώστε με ασφάλεια, και μετά περάστε την πύλη απελευθέρωσης.

Χρήση dry_run σχετικά με υποστηριζόμενες ενέργειες εγγραφής, εκτελέστε το καθορισμένο τεστ σύνδεσης του Builder και επιθεωρήστε το παραγόμενο δηλωτικό και σύμβαση πριν από την απελευθέρωση.

Το \"Dry-run\" γράφει Δοκιμή σύνδεσης με όρια Συμμόρφωση με τη σύμβαση Παράδοση με βάση το Cron

Άνοιγμα του Connector Builder Αναφορά webhook

connector. php · php

κλάση AcmeConnector επέκταση AbstractConnector { δημόσια λειτουργία γυμνοσάλιαγκας (): συμβολοσειρά { επιστροφή \"Άκμη\"; } δημόσια λειτουργία όνομα(): συμβολοσειρά { επιστροφή \"Ακμή\"; } δημόσια λειτουργία περιγραφή(): συμβολοσειρά { επιστροφή \"Γεφυριά του Άκμε\"; } // Χρήση ονομάτων από ConnectorConnectorConstract δημόσια λειτουργία ικανότητες (): συστοιχία { επιστροφή [«ενέργειες», 'webhook']; } δημόσια λειτουργία Σχήμα ρύθμισης (): συστοιχία { επιστροφή [['κλειδί' => 'token', 'τύπος' => \"Λόγος\"]]; } δημόσια λειτουργία ΔοκιμήΣύνδεση(συστοιχία $settings): συστοιχία { επιστροφή [«επιτυχία» => true]; } δημόσια λειτουργία Ενεργοποίηση συστοιχία $payload, συστοιχία $headers, συστοιχία $settings ): συστοιχία { επιστροφή [«επιτυχία» => true]; } }

01 · Σύμβαση συνδέσμου 2.7

Ένα πακέτο δεν μπορεί να διεκδικήσει μια ικανότητα Ο κωδικός του δεν έχει.

OpsIQ\Connectors\ConnectorContract Η ανακάλυψη του χρόνου, ο οικοδόμος, τα πακέτα πρώτου μέρους, η συμμόρφωση, το Γενικό API δηλώστε μια ικανότητα και τρία αρχεία πρέπει να συμφωνήσουν μεταξύ τους πριν OpsIQ Οδεύουμε σε μια μόνο σειρά για σένα.

ΓΕΓΟΝΟΣ. 01πακέτο διασύνδεσης, manifest τμημάτων κλίμακα 1:1 · σύμβαση 2.7

01 connector.php η τάξη του χρόνου εκτέλεσης
02 IdentityProvider.php σταθερό εξωτερικό κλειδί
03 SalesIngest.php συμφιλιώστε τις πωλήσεις()
04 actions.json Ονομαστικές λειτουργίες
05 settings.json διαμόρφωση του φορέα εκμετάλλευσης
06 connector_contract.json μηχανοαναγνώσιμη αρχή

07 signature.json ένα HMAC πάνω από ένα SHA-256 κάθε φακέλου που αναφέρεται ανωτέρω, συν ένα πιστοποιητικό καταγωγής ed25519

Πίνακας ικανότητας όλα τα 59, όπως καταγράφηκαν

δράσεις ενεργοποιήσεις webhook (φύλλο ιστού) journey_events context guest_lookup ταυτότητα sales sales_reconciliation χρέωση payments εμπόριο inbound_ticket outbound_reply ticket_merge ticket_custom_fields secure_details_request sync_users sync_departments sync_orders sync_products sync_projects customer_import security_events security_native_block survey reply_feedback promo_audience promo_feed email_mailbox inbound_email outbound_email mailbox ai_tickets ai_reply ai_brain_aware native_api platform_bridge native_data ρμ block_registry inbound_comment outbound_note outbound_notification oauth reviews τοπικές Σεο site_intelligence Αναλυτικά comms admin_assets enterprise_hooks durable_queue ticket_mirror attachment_bridge database_migrations scheduled_workers conflict_resolution

παραγόμενη 32 δηλωτικό 20 επέκταση 7

Δύο υπογραφές, δύο ερωτήσεις.

hmac-sha256 πάνω από ένα ντετερμινιστικό ωφέλιμο φορτίο ανά αρχείο SHA-256 απαντήσεις hashes έχει τροποποιηθεί από την υπογραφή. Μια ed25519 απαντήσεις υπογραφής Ήταν υπογεγραμμένο από τον Nabtech, checkable με το πακέτο δημόσιο κλειδί και κανένα κοινό μυστικό. Επεξεργασία ενός byte και η πρώτη στάση ταιριάζουν.

marketplace.json είναι εκτός της υπογραφής εξ ορισμού: ο εγκαταστάτης το γράφει μετά την υπογραφή, έτσι ώστε ο εκδότης δεν θα μπορούσε ποτέ να το υπογράψει.

02 · εργαλεία/μετάλλαξη_απόδειξη. php

Ένας φρουρός που δεν απέτυχε ποτέ. είναι αναπόδεικτο.

Οι πράσινοι έλεγχοι δεν σας λένε τίποτα έσπασε σήμερα. Δεν σας λένε ο φύλακας που γράψατε θα σταματήσει το πράγμα γράφτηκε για να σταματήσει, επειδή ένας φρουρός που ποτέ δεν ασκείται περνά ακριβώς σαν ένα φύλακα που δεν κάνει τίποτα. Έτσι σταματάμε την καρδιά του επίτηδες, και απαιτούν ότι η οθόνη ουρλιάζει.

φύλακας · ο αναγνωσμένος ρόλος πρέπει να αρνηθεί μια καταστροφική επιχείρηση CH1 verify_commerce_contracts

src/Connectors/CommerceRoleMapVerifier.php ΤΥΠΟΠΟΙΗΜΕΝΗ

211    /* A read role must never reach a destructive operation. */
212-   if ($isRead && $isDestructive) {
212+   if (false) {
213        $errors[] = "read role '{$role}' points at a destructive op";
214        return false;
215    }

Ακριβώς. ένα Το μηδέν ταιριάζει, ή δύο, και η απόδειξη σταματά πριν μπορεί να πει ψέματα.

$ php tools/mutation_proof.php --spec=proofs.json

1[ ok ]hash    sha256 4f2a9c1e…
          remember the file exactly as it is
2[ ok ]control exit 0
          green BEFORE anything is touched
3[ ok ]mutate  1 match, lint ok
          one replacement, then php -l the mutant
4[RED ]prove   exit 1
          and "read role destructive" IS in the failures
5[ ok ]restore bytes written
          the original, not a regenerated copy
6[ ok ]verify  sha256 matches
          and the check is green again
 ══ PROVEN. file restored, hash matched, 1 proof run, 0 failed.

Μια αποτυχημένη απόδειξη είναι Ποτέ Τα στοιχεία ότι μια επιταγή πήγε στραβά δεν είναι απόδειξη ότι ένας φρουρός δουλεύει.

Η μετάλλαξη δεν εφαρμόστηκε ποτέ.

Το κείμενο αναζήτησης δεν ταιριάζει, το αρχείο ήταν ανέγγιχτο, η σουίτα πέρασε και η απόδειξη καταγράφηκε πράσινο κάτω από τον παλιό κώδικα σχετικά με τον κώδικα που δεν ήταν ποτέ παλιό. Πιάστηκε απαιτώντας ακριβώς ένα textual ταίριασμα και σύγκριση hashes αρχείο κάθε πλευρά.

Η μετάλλαξη έσπασε κάτι άλλο.

Η σουίτα έγινε κόκκινη επειδή το αρχείο σταμάτησε να αναρροφά ή η παγίδα πέθανε, και η απόδειξη κατέγραψε ένα κόκκινο που δεν είχε καμία σχέση με τον φύλακα. όνομα δοκιμή μεταξύ των αποτυχιών.

Δεν μπορεί να αφήσει έναν μεταλλαγμένο στο δίσκο.

Κάθε μετάλλαξη αντιγράφει το πρωτότυπο σε ένα πλευρικό βαγόνι έξω από το δέντρο που εξυπηρετείται από τον ιστό, γράφει έναν δείκτη που κατονομάζει την εξαιρετική αλλαγή και αναιρείται από έναν χειριστή διακοπής λειτουργίας σε κάθε διαδρομή εξόδου.

03 · Συμμόρφωση

Η πιστοποίηση είναι μια εντολή με κωδικό εξόδου.

Όχι μια ουρά ελέγχου όπου κάποιος διαβάζει τον κώδικά σας και σχηματίζει γνώμη. Εκτελέστε τις ίδιες σουίτες δοκιμών που εκτελούμε εμείς, στον δικό σας υπολογιστή, πριν υποβάλετε. Τα δημοσιευμένα σχήματα JSON (8) στο doc/contracts/schemas/ καλύπτουν ρυθμίσεις, ενέργειες, προδιαγραφές Builder, αντιστοιχίσεις συμβάντων ταξιδιού και εμπορίου, συνταγές ροών εργασίας, συμβάσεις συνδέσμων και μανιφέστα εκδόσεων.

manifests parse και συμφωνούν μεταξύ τους
ικανότητες υπάρχει στην τάξη του χρόνου εκτέλεσης
interfaces που έχουν πραγματοποιηθεί, όταν δηλώνονται
files κάθε απαιτούμενο αρχείο παρόν
δράσεις ταίριασμα της δηλωτικής πράξης
destructive δήλωση επιβεβαίωσης
ταυτότητα ένα σταθερό εξωτερικό κλειδί, όχι email
επανάληψη μια επαναλαμβανόμενη ενημέρωση, ποτέ δεν αναπαράγεται
επιχείρηση δηλώσεις που ταιριάζουν με την επέκταση
docs READ, DEVELOPER, ΑΛΛΑΓΗ
Σχήματα κάθε JSON επικυρώσεις

έξοδος 0 acme: conformant against contract 2.7 Μια αποτυχημένη σουίτα ονομάζει την επιταγή και το αρχείο.

$ php tools/test_connector_conformance_all.php --connector=acme $ php tools/test_connector_json_schemas.php $ php tools/verify_commerce_contracts.php $ php tools/release_gate_connectors.php --require-signatures

Να σημειώσουμε την πρώτη σε πραγματικό λογαριασμό μη παραγωγής με --live-settings=/secure/test-acme.jsonΌσο είσαι ακόμα σε επανάληψη, άλλαξε το τελευταίο με --unsigned-ok: αντιμετωπίζει μια χαμένη υπογραφή ως αναμενόμενη προειδοποίηση αντί να προσποιείται ότι είναι εντάξει.

04 · Εμπορικοί ρόλοι.json

Δηλώνοντας τι μπορείτε να πουλήσετε είναι ένα αρχείο, όχι μια καταχώρηση.

Ένας σύνδεσμος που μπορεί να πωλήσει δηλώσεις ποια από από τη δική του Οι λειτουργίες απαντούν στους κανονικούς ρόλους εμπορίου του OpsIQ. Η παρουσία του αρχείου είναι η δήλωση. Εμφανίζεται στις ρυθμίσεις πώλησης τη στιγμή που δηλώνεται και εξαφανίζεται όταν σταματά. Δεν υπάρχει λίστα για συμμετοχή ούτε κάποιος να ρωτήσετε.

κανονικός ρόλος commerce_roles.json την επιχείρησή σας

ΑΠΟΡΡΙΦΘΗΚΕ

Ένα κανονικό Γράφω Η αντιστοίχιση είναι δομική: ένα ουσιαστικό αποθήκευσης δίπλα σε ένα μεταλλασσόμενο ρήμα, ανεξάρτητα από τη σύμβαση ονομασίας σας. Γράφοντας την επιχειρηματική γραμμή παρακάμπτει την τιμολόγηση της πλατφόρμας, το κλείδωμα διαθεσιμότητας και το μήνυμα επιβεβαίωσης και παράγει μια παραγγελία στην οποία το σύστημα του εμπόρου πιστεύει μόνο κατά το ήμισυ. recovery Ούτε, έτσι ένα τάιμ άουτ θα ήταν μη ανακτήσιμο.

commerce_roles.jsonΒΑΛΙΔ

{
  "commerce": {
    "roles": {
      "catalog_search": { "operation": "acme_search_products", "transport": "http" },
      "order_get":      { "operation": "acme_get_order",       "transport": "http" },
      "order_create":   { "operation": "acme_create_order",    "transport": "http",
                         "recovery":  "acme_get_order" }
    }
  }
}

Ο δικός του φάκελος επίτηδες: connector_contract.json παράγεται και τα σχήματα του additionalProperties:falseΈτσι, ένα χειρόγραφο μπλοκ εκεί θα αποτύχει επικύρωση και στη συνέχεια να αντικατασταθεί στην επόμενη λειτουργία γεννήτρια.

Κλειστό λεξιλόγιο

Ένας ρόλος που δεν είναι CommerceRole δεν υπάρχει. OpsIQ Ποτέ δεν αναφέρεται σε ένα όνομα λειτουργίας, επειδή ένα όνομα δεν είναι υπόσχεση.

Η δική σου δράση

Η επέμβαση πρέπει να εμφανιστεί στο δικό σας actions.json. Δηλώνοντας ένα που δεν υπάρχει υπόσχεται στον πελάτη κάτι που στη συνέχεια παράγει τίποτα.

Εγγραφή δήλωσης ανάκτησης

Το πιο επικίνδυνο χρονικό όριο είναι αυτό που έρχεται αφού η πλατφόρμα έχει ήδη κάνει τη δουλειά της.Χωρίς μια αναζήτηση οι μόνες επιλογές είναι να προσπαθήσουμε πάλι στα τυφλά ή να χάσουμε την παραγγελία.

Πιστοποιούν τους ρόλους πληρωμής

Κάθε ρόλος κλάσης πληρωμής δηλώνει επίσης payment_profile με το περιβάλλον, webhook_verify χρήση του συστήματος του ίδιου του παρόχου, και event_map. Ένα μη δηλωμένο περιβάλλον είναι το πώς ένας πάροχος test-mode παίρνει μια ζωντανή πληρωμή.

Ο κατασκευαστής επικυρώνει αυτά καθώς πληκτρολογείτε και ο ελεγκτής επικυρώνει το πακέτο που αποστέλλεται. Και οι δύο καλέστε τις ίδιες λειτουργίες, οπότε δεν μπορούν να διαφωνήσουν.

⚖️ Πώς συγκρίνεται

OpsIQ vs α DIY ενσωμάτωση.

Τι συμβόλαιο, υπογεγραμμένη, ελεγχόμενη πλατφόρμα σου δίνει ότι το να τραβάς τα δικά σου δικτυωτά και τα υδραυλικά AI-action δεν θα το κάνουν ποτέ.

Ικανότητα	Γύρνα το δικό σου.	OpsIQ
Scoped Bearer API + HMAC-signed webhooks	Που έχουν ελαθεί στο χέρι	✓
Το dry-run γράφει + 24-hour επιτυχής επανάληψη	Φτιάξε το μόνος σου	✓
1m → 5m → 30m → 2h → 12h retries	DIY ουρά	✓
Μητρώο συμβάσεων δράσης (το AI δεν μπορεί να εφεύρει κλήσεις)	—	✓
Πολιτική επιβεβαίωσης πριν από τις παρενέργειες	—	✓
Σταθερός φάκελος σφάλματος + ζητήστε ταυτότητες	Χειροκίνητη καταγραφή	✓
Άμεση επιλογή HTTP + δημιουργημένων πελατών	Γράψε το δικό σου.	✓
OpenAPI 3.0.3 σύμβαση αναγνώσιμη από μηχάνημα	Ίσως.	✓
Εξι σταδιοχτητής + πύλη απελευθέρωσης πακέτου	Κατασκευή μιας αλυσίδας εργαλείων	✓
Κλειδί με έλικα και ωριαία όρια	Βάρη	✓
Μοτίβο σύνδεσης: ο κώδικας πλατφόρμας παραμένει απομονωμένος	—	✓

Συχνές ερωτήσεις

Ερωτήσεις προγραμματιστή, Απάντησε.

Ταυτοποίηση, συμβάσεις, επαναφορτίσεις, παραγωγή πελατών, ασφαλείς δοκιμές και το μοντέλο σύνδεσης, πριν από την πρώτη αίτηση παραγωγής.

Γενικά API αποστολή κλήσεων Authorization: Bearer opq_…. Τα κλειδιά μπορεί να είναι χωρίς περιορισμούς, περιορισμένα ή μόνο για ανάγνωση, φέρουν εμβέλειες ελάχιστων δικαιωμάτων, υπακούουν σε ωριαίο όριο και μπορούν να δεσμευτούν σε έναν χώρο εργασίας. Η υπογραφή webhook είναι ξεχωριστή: οι εξερχόμενες παραδόσεις φέρουν X-OpsIQ-Signature, X-OpsIQ-Timestamp, X-OpsIQ-Event και X-OpsIQ-Delivery.

Όχι. Η AI μπορεί να προτείνει μόνο τις ονομαζόμενες λειτουργίες στο μητρώο δράσης. Κάθε σύμβαση που δημιουργείται δηλώνει πεδίο εφαρμογής, πεδία αίτησης, πολιτική κινδύνου και επιβεβαίωσης· οι πράξεις των οποίων η πολιτική απαιτεί επιβεβαίωση επικαλύπτονται σε μια ανθρώπινη προεπισκόπηση πριν από την εκτέλεση.

Επαναφορά hash_hmac('sha256', $rawBody, $secret) και να συγκρίνουν την δεκαεξαδική χωνεμένη με X-OpsIQ-Signature με hash_equals. Επικύρωση X-OpsIQ-Timestamp μέσα στο παράθυρο αναπαραγωγής και χρήση X-OpsIQ-Delivery ως αναγνωριστικό της παραδόσεως που μπορεί να ανιχνευθεί.

Μια ανεπιτυχής προσπάθεια εισέρχεται στην ουρά παράδοσης στο παρασκήνιο. OpsIQ Επαναλήψεις στο. 1-λεπτό, 5-λεπτό, 30-λεπτό, 2- ώρα και 12-ώρα σκάλα διατηρώντας το αναγνωριστικό παράδοσης και την ιστορία προσπάθειας για τη διάγνωση.

Καλέστε απευθείας την επιφάνεια ενεργειών JSON, εισαγάγετε τη δημιουργημένη συλλογή Postman ή δημιουργήστε πελάτη από το OpenAPI 3.0.3. Οι αποστολείς αναφοράς PHP και οι πελάτες ενσωμάτωσης Node/Python υποστηρίζουν ροές συμβάντων και webhook· είναι βοηθητικά εργαλεία και όχι ξεχωριστά συμβόλαια API.

Χρήση dry_run σε ενέργειες των οποίων η σύμβαση που δημιουργήθηκε το υποστηρίζει, εκτελέστε τον περιορισμένο έλεγχο σύνδεσης του Connector Builder, εξετάστε τα αρχεία που δημιούργησε και περάστε τους ελέγχους συμμόρφωσης πακέτου και έκδοσης πριν θεωρήσετε τη διασύνδεση έτοιμη.

Η εγκατεστημένη απελευθέρωση παράγει API και συμβόλαια σύνδεσης από τα δικά του μητρώα χρόνου λειτουργίας. URL, μυστικά, αποθήκευση και cron/εργαζόμενοι, έτσι η συμπεριφορά θα πρέπει να επαληθεύεται κατά την εγκατεστημένη απελευθέρωση παρά να θεωρείται από ένα περιβάλλον σύννεφο.

Ένας σύνδεσμος είναι ένα ρυθμιζόμενο πακέτο που περιέχει τον προσαρμογέα, settings.json, προαιρετικό actions.json, μια παραγόμενη σύμβαση δυνατοτήτων, τεκμηρίωση και προαιρετικές εταιρικές επεκτάσεις. Ο Builder έξι σταδίων το συναρμολογεί, το μητρώο το εντοπίζει και οι έλεγχοι συμμόρφωσης και έκδοσης το επικυρώνουν.