List a video’s locales

use Fetchski\AttractCmsLaravel\Facades\Attract;

$documentLocales = Attract::videos()->getVideoLocales(id: 'clx8m2k4p0000a1b2c3d4e5f6');

{
  "results": [
    {}
  ]
}

In your app

<?php

declare(strict_types=1);

namespace App\Http\Controllers;

use Fetchski\AttractCmsLaravel\Data\DocumentLocales;
use Fetchski\AttractCmsLaravel\Facades\Attract;

final class GetVideoLocalesController
{
    public function __invoke(string $id): DocumentLocales
    {
        return Attract::videos()->getVideoLocales(id: $id);
    }
}

use App\Http\Controllers\GetVideoLocalesController;
use Illuminate\Support\Facades\Route;

Route::get('/video/{id}/locales', GetVideoLocalesController::class);

curl http://localhost:8000/video/clx8m2k4p0000a1b2c3d4e5f6/locales

php artisan make:attract-action videos.getVideoLocales

Call it from the terminal

php artisan attract:call videos.getVideoLocales id=clx8m2k4p0000a1b2c3d4e5f6

Find the id

use Fetchski\AttractCmsLaravel\Facades\Attract;

$row = Attract::videos()->listVideosPick(fields: ['title', 'slug'])->firstWhere('slug', 'getting-started'); // ['id' => …, 'title' => …, 'slug' => …], or null

php artisan attract:call videos.listVideosPick fields=title,slug

Behavior

• Access: an API key with content:videos:read (or a master above it: content:videos:all, content:all, admin:all) reads the published documents; drafts (a draft _id) need content:videos:write (or a master above it). A signed-in person may call it as far as their own permissions allow; anyone else gets 404.
• Rate limit: the key’s own reads-per-minute limit, set when the key is created (default 600); over it, 429 with Retry-After. The client waits and retries for you; you see RateLimited only if that runs out.
• Retries: a read is safe to repeat: the client retries it on no answer, a 502/503/504 and a 429.
• Timeout: 15 s per attempt by default; raise timeout in config/fetchski-attract.php for longer.

Test it

<?php

declare(strict_types=1);

namespace Tests\Feature;

use Fetchski\AttractCmsLaravel\Facades\Attract;
use Tests\TestCase;

final class GetVideoLocalesTest extends TestCase
{
    public function test_get_video_locales(): void
    {
        Attract::fake();

        $this->getJson('/video/clx8m2k4p0000a1b2c3d4e5f6/locales')->assertOk();

        Attract::assertCalled('videos.getVideoLocales', fn (array $args): bool => $args['id'] === 'clx8m2k4p0000a1b2c3d4e5f6');
    }
}

php artisan test

Related