Ocean; tarama verilerine, kullanıcı bilgisine, risk skorlarına ve tespit sistemlerine programatik erişim için bir REST API sunar. Tüm uç noktalar API anahtarı kullanır ve saatte 1.000 istekle sınırlıdır.
Ocean API yalnızca şunlara sahip kullanıcılar içindir: aktif lisans veya Enterprise üyeliği. Ücretsiz kullanıcılar API anahtarı oluşturamaz ve kullanamaz.
Tek istisna /v1/version, herkese açıktır ve API anahtarı gerekmez.
Temel URL: https://api.anticheat.ac/v1
Kimlik doğrulama: API anahtarını şu üst bilgide gönder: x-api-key
İsteğe bağlı: Gönder x-server-name çağrıyı hangi sunucunun yaptığını etiketlemek için
/v1/scanned-users/lookup/:discordIdBir Discord kullanıcısının tarama geçmişini, tespitlerini, ban veya uyarı durumunu ve ilişkili hesaplarını sorgula
İzin:scanned-users:lookup/v1/users/:discordId/risk-scoreBir Discord kullanıcısının hesaplanan risk skorunu ve seviyesini al
İzin:user:risk-score/v1/pins/:pinCode/resultsKendi PIN'lerinin tarama sonuçlarını programatik olarak getir
İzin:pins:results/v1/pins/:pinCode/statusPIN'lerinin anlık tarama ilerlemesini, yüzdeyi ve sonuç özetini al
İzin:pins:status/v1/pins/createAPI ile tarama PIN'i oluştur. Yalnızca Enterprise sahipleri.
İzin:pins:create (Enterprise sahibi)/v1/db/query/:discordIdHileci veritabanını Discord ID ile ara: topluluk profili, ağ sorgusu ve Ocean tarama eşleşmeleri
İzin:db:query (DB erişimi)/v1/versionAktif Ocean istemci sürümünü oku. Bir sürüm denetleyicisi için ideal
İzin: yok, bu uç nokta herkese açıkhttps://api.anticheat.ac/mcpREST API ile aynı veriyi Streamable HTTP üzerinden yapay zeka ajanlarına sunan uzak MCP sunucusu
Kimlik doğrulama:OAuth 2.1Kullanım kaydı
Kimliği doğrulanmış her API çağrısı kaydedilir: hangi anahtar, hangi uç nokta, çağıran IP ve isteğe bağlı x-server-name üst bilgisi. Kayıtlar 90 gün tutulur ve anahtar paylaşımı ile kötüye kullanımı görmek için kullanılır. Tam API anahtarını içermez, yalnızca ilk 12 karakterini.
Bir anahtar birden fazla sunucuya hizmet ediyorsa her birinden farklı bir x-server-name gönder. Hangi sunucunun çağrı yaptığını göstermenin en hızlı yoludur.
Hız sınırlaması
Tüm uç noktalar şu genel sınırı paylaşır: Saatte 1.000 istek API anahtarı başına. Hız sınırı üst bilgileri (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset) her yanıtta bulunur.