API-Referenz

AvatarShot bietet REST-Endpunkte für Second-Life-Integrationen, einschließlich Login-Abläufen für Konten, Feed-Veröffentlichung und Marketplace-Automatisierung.

Basis-URL

https://avatarshot.com/api/sl

Authentifizierung

Alle authentifizierten Anfragen erfordern einen API-Key-Header:

X-Api-Key: YOUR_API_KEY

Konto-Endpunkte

POST /sl/login

Fordert einen Login-OTP-Code für einen Avatar an.

{
    "avatar_name": "Slender Huntsman",
    "avatar_key": "uuid-here"
}

Antwort:

{
    "success": true,
    "code": "123456",
    "message": "Use this code on avatarshot.com/verify to login",
    "expires_in": 600
}

POST /sl/register

Registriert schnell einen neuen Nutzer aus der Welt heraus.

POST /sl/status

Prüft, ob ein Nutzer registriert ist, und dessen Plan-Status.

GET /sl/plans

Ruft verfügbare Abonnementpläne mit L$-Preisen ab.

POST /sl/payment

Verarbeitet eine L$-Zahlung für ein Abonnement-Upgrade.

Feed-Endpunkte

POST /sl/feed

Veröffentlicht einen Beitrag im Feed aus der Welt heraus. Unterstützt Bild-URL, Textur-UUID oder Base64.

{
    "avatar_name": "Slender Huntsman",
    "caption": "My new look!",
    "image_url": "https://example.com/photo.jpg",
    "tags": "fashion, secondlife",
    "location": "Backdrop City"
}

POST /sl/feed/limit

Prüft das verbleibende tägliche Beitragslimit eines Nutzers.

Marketplace-Endpunkte

POST /sl/marketplace/purchase

Registriert einen Kauf in der Welt (wird vom Vendor-Skript aufgerufen).

{
    "product_id": 123,
    "buyer_name": "Customer Name",
    "buyer_uuid": "buyer-uuid-here",
    "amount": 500,
    "transaction_id": "unique-id"
}

Antwort:

{
    "success": true,
    "message": "Purchase confirmed! Delivering...",
    "order_number": "AS-XXXXXXXX",
    "deliver_uuid": "product-inventory-uuid",
    "deliver_to": "buyer-uuid"
}

POST /sl/marketplace/product-info

Ruft Produktinformationen für die Vendor-Anzeige ab.

{ "product_id": 123 }

POST /sl/marketplace/pending-deliveries

Ruft ausstehende Lieferungen ab (für den Delivery Bot).

POST /sl/marketplace/confirm-delivery

Bestätigt, dass eine Lieferung gesendet wurde oder fehlgeschlagen ist.

{
    "delivery_id": 456,
    "status": "sent"
}

ANS-Endpunkt

POST /sl/ans/{store_key}

Empfängt Kaufbenachrichtigungen des SL Marketplace. Diese URL wird in Ihren SL-Marketplace-Händlereinstellungen konfiguriert. Siehe ANS-Integrationsleitfaden.

Fehlerantworten

Endpunkte liefern JSON-Payloads mit einem success-Feld und aussagekräftigen Meldungswerten:

{
    "success": false,
    "message": "Error description here"
}

Ratenlimits

Login/Registrierung: 5 Anfragen pro Minute
Feed-Beiträge: abhängig vom Nutzerplan (Free: 10/Tag, Pro: unbegrenzt)
Marketplace: 60 Anfragen pro Minute

Implementieren Sie für produktive Integrationen Wiederholungsversuche mit exponentiellem Backoff und protokollieren Sie alle fehlgeschlagenen Aufrufe mit Anfragekennungen.