base_url = rtrim((string) $base_url, '/'); $this->api_key = (string) $api_key; } public function health() { $r = $this->request('GET', '/api/v1/health'); return $r && isset($r['status']) && 'ok' === $r['status']; } /** * $user_agent: lo user agent del visitatore (piattaforma 0.73.9+), con cui * la piattaforma separa i click dei bot. null = campo non mandato (il * click conta come sempre); stringa vuota = nessuno user agent, cioe' bot. */ public function track_click($referral_code, $landing_url, $campaign = null, $event_id = null, $occurred_at = null, $user_agent = null) { $body = array( 'referral_code' => $referral_code, 'landing_url' => $landing_url, 'campaign' => $campaign, 'client_event_id' => $event_id, 'occurred_at' => $occurred_at, ); if (null !== $user_agent) { $body['user_agent'] = (string) $user_agent; } return $this->request('POST', '/api/v1/track/click', $body); } /** * Ritrasmette in un colpo solo i click rimasti in coda. * * A lotti e non uno per uno perche' il recupero e' per definizione una * raffica: dopo un'interruzione possono essercene centinaia, e il * limitatore della piattaforma taglierebbe la coda a meta' strada. */ public function track_clicks(array $clicks) { return $this->request('POST', '/api/v1/track/click', array('clicks' => $clicks)); } public function list_links($referral_code) { return $this->request('GET', '/api/v1/links?affiliate_ref=' . rawurlencode($referral_code)); } public function create_link($referral_code, $label) { return $this->request('POST', '/api/v1/links', array( 'referral_code' => $referral_code, 'label' => $label, )); } public function order_event($event, array $order) { return $this->request('POST', '/api/v1/webhooks/orders', array( 'event' => $event, 'order' => $order, )); } public function list_affiliates($status = null) { return $this->request('GET', '/api/v1/affiliates' . ($status ? '?status=' . rawurlencode($status) : '')); } public function create_affiliate(array $data) { return $this->request('POST', '/api/v1/affiliates', $data); } public function update_affiliate($id, array $patch) { return $this->request('PATCH', '/api/v1/affiliates/' . rawurlencode($id), $patch); } /** Scheda del singolo affiliato, con i dati per il bonifico (piattaforma 0.73.10+). */ public function get_affiliate($id) { $r = $this->request('GET', '/api/v1/affiliates/' . rawurlencode($id)); return ($r && !empty($r['affiliate'])) ? $r['affiliate'] : null; } /** * IBAN e intestatario inseriti dall'affiliato nella sua area. IBAN vuoto * li cancella entrambi. Errori 422: `invalid_iban`, `holder_required`. */ public function update_payout_details($id, $iban, $holder) { return $this->request('PATCH', '/api/v1/affiliates/' . rawurlencode($id), array( 'payout_iban' => (string) $iban, 'payout_holder' => (string) $holder, 'payout_updated_by' => 'affiliate', )); } public function stats($months = 6) { return $this->request('GET', '/api/v1/stats?months=' . (int) $months); } public function raw_get($path) { if (!$this->base_url || !$this->api_key) { return null; } $res = wp_remote_get($this->base_url . $path, array( 'timeout' => 15, 'headers' => array('X-AT-Key' => $this->api_key), )); if (is_wp_error($res) || wp_remote_retrieve_response_code($res) >= 400) { return null; } return wp_remote_retrieve_body($res); } // Con il referral e' la vista dell'affiliato: gli ordini in "solo // conteggio" del suo codice non entrano nel totale ordini (stanno nel // conteggio del codice). public function summary($referral_code = null) { return $this->request('GET', '/api/v1/module/summary' . ($referral_code ? '?affiliate_ref=' . rawurlencode($referral_code) . '&view=affiliate' : '')); } public function settings() { $r = $this->settings_full(); return ($r && !empty($r['settings'])) ? $r['settings'] : null; } /** * La risposta intera, non solo il ramo `settings`: accanto alla * configurazione del programma la piattaforma manda campi gia' risolti che * il connettore non saprebbe calcolare da se' (`track_mode_effective`, * `store_name`). */ public function settings_full() { return $this->request('GET', '/api/v1/settings'); } public function levels() { return $this->request('GET', '/api/v1/levels'); } public function create_level(array $data) { return $this->request('POST', '/api/v1/levels', $data); } public function delete_level($id) { return $this->request('DELETE', '/api/v1/levels/' . rawurlencode($id)); } // Rettifica manuale del saldo (EUR e/o COIN) con nota di audit. public function adjust_affiliate($id, $eur, $coins, $note = null) { return $this->request('POST', '/api/v1/affiliates/' . rawurlencode($id) . '/adjust', array( 'eur' => (float) $eur, 'coins' => (int) $coins, 'note' => $note, )); } public function commissions($referral_code, $limit = 50) { return $this->request('GET', '/api/v1/commissions?affiliate_ref=' . rawurlencode($referral_code) . '&limit=' . (int) $limit); } public function notifications($referral_code) { return $this->request('GET', '/api/v1/notifications?affiliate_ref=' . rawurlencode($referral_code)); } /** Senza $ids segna lette tutte le notifiche dell'affiliato. */ public function mark_notifications_read($referral_code, array $ids = array()) { $body = array('affiliate_ref' => $referral_code); if (!empty($ids)) { $body['ids'] = array_values($ids); } return $this->request('POST', '/api/v1/notifications/read', $body); } // L'id cliente e' per-negozio ma gli affiliati sono per-tenant: su un // tenant con piu' negozi (PS+Woo) gli id collidono. La piattaforma cerca // prima per email e poi per id cliente. public function get_affiliate_by_customer($external_customer_id, $email = null) { $q = '/api/v1/affiliates?external_customer_id=' . rawurlencode((string) $external_customer_id); if ($email) { $q .= '&email=' . rawurlencode((string) $email); } $r = $this->request('GET', $q); return ($r && !empty($r['affiliates'])) ? $r['affiliates'][0] : null; } public function request_discount($referral_code, $coins) { return $this->request('POST', '/api/v1/discounts/request', array( 'referral_code' => $referral_code, 'coins' => (int) $coins, )); } public function pending_discounts() { return $this->request('GET', '/api/v1/discounts/pending'); } public function confirm_discount($request_id, $status, $external_code = null) { return $this->request('POST', '/api/v1/discounts/confirm', array( 'request_id' => $request_id, 'status' => $status, 'external_code' => $external_code, )); } public function report_revenue($revenue_12m, $currency = null) { return $this->request('POST', '/api/v1/module/revenue', array( 'revenue_12m' => (float) $revenue_12m, 'currency' => $currency, )); } /* Codici sconto degli influencer (piattaforma 0.69.0+): elenco da applicare, esito nel negozio, ordini del recupero. */ public function codes() { return $this->request('GET', '/api/v1/codes'); } public function codes_sync(array $results) { return $this->request('POST', '/api/v1/codes/sync', array('results' => $results)); } public function codes_recovery($code, array $orders, $done) { return $this->request('POST', '/api/v1/codes/recovery', array( 'code' => (string) $code, 'orders' => $orders, 'done' => (bool) $done, )); } /* Vero se l'ultima chiamata non ha avuto risposta utile dalla piattaforma * (rete, 5xx, 401/402/403): distingue "la piattaforma ha detto no/niente" * da "la piattaforma non ha risposto", che per chi mostra una pagina al * cliente sono due cose diverse. */ private $last_failed = false; public function last_failed() { return $this->last_failed; } private function request($method, $path, array $body = null) { $this->last_failed = false; if (!$this->base_url || !$this->api_key) { $this->last_failed = true; return null; } $args = array( 'method' => $method, 'timeout' => 8, 'headers' => array('X-AT-Key' => $this->api_key), ); if (null !== $body) { $args['headers']['Content-Type'] = 'application/json'; $args['body'] = wp_json_encode($body); } $res = wp_remote_request($this->base_url . $path, $args); $code = is_wp_error($res) ? 0 : (int) wp_remote_retrieve_response_code($res); // Chiave errata, abbonamento fermo, vietato: il corpo e' solo un // messaggio d'errore che nessun chiamante sa usare. Il 4xx di // validazione (409 codice preso, 422 saldo insufficiente) resta. if (0 === $code || $code >= 500 || in_array($code, array(401, 402, 403), true)) { $this->last_failed = true; return null; } $decoded = json_decode(wp_remote_retrieve_body($res), true); return is_array($decoded) ? $decoded : null; } }