Referencia de API

AvatarShot proporciona endpoints REST para integraciones de Second Life, incluidos flujos de inicio de sesión de cuenta, publicación en el feed y automatización del marketplace.

URL Base

https://avatarshot.com/api/sl

Autenticación

Todas las solicitudes autenticadas requieren un encabezado de clave de API:

X-Api-Key: YOUR_API_KEY

Endpoints de Cuenta

POST /sl/login

Solicita un código OTP de inicio de sesión para un avatar.

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

Respuesta:

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

POST /sl/register

Registra rápidamente un nuevo usuario desde dentro del mundo.

POST /sl/status

Verifica si un usuario está registrado y el estado de su plan.

GET /sl/plans

Obtén los planes de suscripción disponibles con precios en L$.

POST /sl/payment

Procesa un pago en L$ para una actualización de suscripción.

Endpoints del Feed

POST /sl/feed

Publica en el feed desde dentro del mundo. Admite URL de imagen, UUID de textura o 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

Verifica el límite diario de publicaciones restante para un usuario.

Endpoints del Marketplace

POST /sl/marketplace/purchase

Registra una compra dentro del mundo (llamado por el script del vendedor).

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

Respuesta:

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

POST /sl/marketplace/product-info

Obtén información del producto para la visualización del vendedor.

{ "product_id": 123 }

POST /sl/marketplace/pending-deliveries

Obtén las entregas en cola (para el bot de entrega).

POST /sl/marketplace/confirm-delivery

Confirma que una entrega fue enviada o falló.

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

Endpoint de ANS

POST /sl/ans/{store_key}

Recibe las notificaciones de compra del SL Marketplace. Esta URL se configura en la configuración de comerciante de tu SL Marketplace. Consulta la Guía de Integración ANS.

Respuestas de Error

Los endpoints devuelven payloads JSON con un campo success y valores de mensaje descriptivos:

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

Límites de Frecuencia

• Inicio de sesión/Registro: 5 solicitudes por minuto
• Publicaciones en el feed: Según el plan del usuario (Gratis: 10/día, Pro: ilimitadas)
• Marketplace: 60 solicitudes por minuto

Para integraciones de producción, implementa reintentos con retroceso exponencial y registra todas las llamadas fallidas con identificadores de solicitud.