List an author’s locales

use Fetchski\AttractCmsLaravel\Facades\Attract;

$documentLocales = Attract::authors()->getAuthorLocales(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 GetAuthorLocalesController
{
    public function __invoke(string $id): DocumentLocales
    {
        return Attract::authors()->getAuthorLocales(id: $id);
    }
}

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

Route::get('/author/{id}/locales', GetAuthorLocalesController::class);

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

php artisan make:attract-action authors.getAuthorLocales

Call it from the terminal

php artisan attract:call authors.getAuthorLocales id=clx8m2k4p0000a1b2c3d4e5f6

Find the id

use Fetchski\AttractCmsLaravel\Facades\Attract;

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

php artisan attract:call authors.listAuthorsPick fields=title,slug

Behavior

• Access: an API key with content:authors:read (or a master above it: content:authors:all, content:all, admin:all) reads the published documents; drafts (a draft _id) need content:authors:write (or a master above it). A signed-in person reads as far as their own permissions allow, and anyone else reads the published documents’ public fields.
• 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 GetAuthorLocalesTest extends TestCase
{
    public function test_get_author_locales(): void
    {
        Attract::fake();

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

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

php artisan test

Related