Allmine API
Live Streams

Misafir olarak canlı yayına katılmak için Agora tokenı al

**Production uyarisi:** Bu endpoint veri degistirir veya operasyon tetikleyebilir. API Playground icinde Production server seciliyse gercek production verisi etkilenir; test icin Development server kullanin. Misafir olarak belirli bir canlı yayına katılması için gerekli Agora tokenını döndürür.

POST
/api/v1/live-stream/join-as-guest

Production uyarisi: Bu endpoint veri degistirir veya operasyon tetikleyebilir. API Playground icinde Production server seciliyse gercek production verisi etkilenir; test icin Development server kullanin.

Misafir olarak belirli bir canlı yayına katılması için gerekli Agora tokenını döndürür.

Authorization

JWT-auth
AuthorizationBearer <token>

Paste the JWT access token without the Bearer prefix.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

liveStreamId*string

Hangi canlı yayına katılacağını belirten ID

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/v1/live-stream/join-as-guest" \  -H "Content-Type: application/json" \  -d '{    "liveStreamId": "64efc0b21a3d2c001234abcd"  }'
{
  "isSuccess": true,
  "statusCode": 200,
  "data": {
    "liveStream": {
      "id": "64d15f9e2e6c8f4d5a123456",
      "title": "Yeni ürün tanıtımı",
      "liveStreamType": "solo",
      "channelName": "yeni-urun-tanitimi-1a2b",
      "broadcasters": [],
      "guests": [],
      "creator": {
        "_id": "64d15f9e2e6c8f4d5a123456",
        "username": "johndoe",
        "name": "John",
        "surname": "Doe",
        "profilePhoto": {
          "_id": "507f1f77bcf86cd799439012",
          "url": "https://example.com/uploads/images/profile.jpg",
          "type": "image",
          "variants": {
            "40": "https://cdn.example.com/profiles/user/40.webp",
            "76": "https://cdn.example.com/profiles/user/76.webp"
          },
          "createdAt": "2024-01-15T10:30:00.000Z",
          "updatedAt": "2024-01-15T12:30:00.000Z"
        },
        "availabilityStatus": "available"
      },
      "thumbnailUrl": "https://cdn.example.com/stream/thumbnail.png",
      "recording": false,
      "recordingUrl": "https://cdn.example.com/stream/archive.mp4",
      "replayAccess": {
        "status": "owner",
        "canRent": true,
        "canViewRecording": true,
        "price": 50,
        "rentedAt": "2026-01-15T10:30:00.000Z",
        "expiresAt": "2026-01-15T10:30:00.000Z",
        "remainingSeconds": 3600
      },
      "status": "active",
      "accessType": "free",
      "price": 9.99,
      "interest": "music",
      "durationGoal": 60,
      "motivation": "Bu yayında müzik hakkında konuşacağım ve sizlerle deneyimlerimi paylaşacağım.",
      "isActiveReplayOnCreatorProfile": null,
      "replayCreditPrice": null,
      "startedAt": "2026-01-15T10:30:00.000Z",
      "plannedStartDate": "2026-01-15T10:30:00.000Z",
      "endedAt": "2026-01-15T10:30:00.000Z",
      "plannedEndDate": "2026-01-15T10:30:00.000Z",
      "createdAt": "2026-01-15T10:30:00.000Z",
      "updatedAt": "2026-01-15T10:30:00.000Z",
      "fundingGoal": 1000,
      "collectedFunding": 500,
      "fundingPercentage": 50,
      "role": "host",
      "miniCrowdFundings": []
    },
    "agora": {
      "appId": "64d15f9e2e6c8f4d5a123456",
      "channelName": "sample",
      "token": "sample",
      "uid": 123456,
      "role": "host",
      "expiresAt": "2026-01-15T10:30:00.000Z"
    },
    "rtm": {
      "appId": "64d15f9e2e6c8f4d5a123456",
      "channelName": "sample",
      "userId": "64d15f9e2e6c8f4d5a123456",
      "token": "sample",
      "expiresAt": "2026-01-15T10:30:00.000Z"
    }
  },
  "errors": [],
  "timestamp": "2026-05-22T16:11:27.023Z"
}
{
  "isSuccess": false,
  "statusCode": 400,
  "data": null,
  "errors": [
    "Validation failed"
  ],
  "timestamp": "2026-01-15T10:30:00.000Z"
}
{
  "isSuccess": false,
  "statusCode": 401,
  "data": null,
  "errors": [
    "Authentication required"
  ],
  "timestamp": "2026-01-15T10:30:00.000Z"
}
{
  "isSuccess": false,
  "statusCode": 403,
  "data": null,
  "errors": [
    "Insufficient permissions"
  ],
  "timestamp": "2026-01-15T10:30:00.000Z"
}
{
  "isSuccess": false,
  "statusCode": 404,
  "data": null,
  "errors": [
    "Resource not found"
  ],
  "timestamp": "2026-01-15T10:30:00.000Z"
}
{
  "isSuccess": false,
  "statusCode": 409,
  "data": null,
  "errors": [
    "Resource already exists or cannot be changed in its current state"
  ],
  "timestamp": "2026-01-15T10:30:00.000Z"
}