DeHub API Başvurusu — REST ve Mastodon API’leri

DeHub’ın iki HTTP API’si var. Mastodon uyumlu API, üçüncü taraf uygulamalar için kararlı olanıdır. DeHub REST API’si dehub.io’yu ve telefon uygulamasını çalıştırır ve tüm özellikleri kapsar.

Temel URL’ler

API	Temel URL	En uygun olduğu
Mastodon uyumlu	`https://riftn.com/api/v1`	İnsanları giriş yaptıran, zaman akışlarını okuyan ve paylaşım yapan uygulamalar. Her Mastodon kütüphanesiyle çalışır.
DeHub REST	`https://api.dehub.io/api`	DeHub’ın yaptığı her şey: akışlar, videolar, canlı yayın, bahşişler, arama, sıralamalar.
MCP	`https://riftn.com/mcp`	Yapay zekâ ajanları ve asistanları. Bakınız: Bağlan.

Her uç noktayı ve bir Dene düğmesini içeren tam REST başvurusu şurada: api.dehub.io/api/docxx. Makinece okunabilir OpenAPI dosyası şurada: api.dehub.io/api/docxx-json; kod üreticileri ve API istemcileri için hazır.

Başlamak için herkese açık uç noktalar

Bunlar giriş gerektirmez:

# A profile, by handle or wallet
curl https://api.dehub.io/api/account_info/dehub

# The public feed
curl 'https://api.dehub.io/api/feed?limit=10'

# Search people and posts
curl 'https://api.dehub.io/api/search?q=music'

# The DHB leaderboard
curl https://api.dehub.io/api/leaderboard

# Public timeline, Mastodon format
curl 'https://riftn.com/api/v1/timelines/public?limit=20'

Kimlik doğrulama

Mastodon uyumlu API için şununla bir kullanıcı tokenı alın: OAuth ve şu şekilde gönderin: Authorization: Bearer TOKEN. REST API, biri giriş yaptığında dehub.io’nun ve telefon uygulamasının aldığı kısa ömürlü oturum tokenlarını kullanır; üçüncü taraf uygulamalar kullanıcılar adına Mastodon uyumlu API üzerinden işlem yapmalıdır.

İstek sınırları

Her REST yanıtı mevcut sınırlarınızı taşır:

x-ratelimit-limit-short: 20      # per 10 seconds
x-ratelimit-remaining-short: 19
x-ratelimit-limit-medium: 100    # per minute
x-ratelimit-limit-long: 500      # per 15 minutes
x-ratelimit-reset-long: 900

Sınırlar IP adresi ve uç nokta başına sayılır. Bir sınırı aşarsanız şunu alırsınız: 429 Too Many Requests; ilgili reset değerindeki saniye kadar bekleyin. Bazı uç noktaların daha sıkı kendi sınırları vardır ve çok sayıda kişiyi takip etmek gibi toplu işlemler için toplu uç noktalar bulunur.

Hatalar

Önce HTTP durumuna bakın. Hatalar şu biçimlerden birinde JSON olarak gelir:

{ "error": "Not Found: Account not found", "result": false }
{ "statusCode": 400, "message": "limit must be a number", "error": "Bad Request" }

Mastodon uyumlu API hataları her zaman şu biçimde döndürür: { "error": "…" }; Mastodon istemcilerinin beklediği gibi.

Kimlikler

Kişiler küçük harfli cüzdan adresleriyle (0x…) ve ayrıca kullanıcı adlarıyla tanımlanır. Gönderilerin bağlantılarında görünen sayısal bir kimliği vardır: dehub.io/app/post/7180.