69 lines
1.9 KiB
PHP
69 lines
1.9 KiB
PHP
<?php
|
|
|
|
namespace App\Http\Controllers\Api\Base;
|
|
|
|
use Illuminate\Http\JsonResponse;
|
|
use Illuminate\Support\Facades\Log;
|
|
use Symfony\Component\HttpFoundation\BinaryFileResponse;
|
|
|
|
/**
|
|
* 공개 API용 베이스 컨트롤러
|
|
*
|
|
* 인증이 필요하지 않은 공개 API 컨트롤러가 상속받아야 하는 기본 클래스입니다.
|
|
* 캐싱, 속도 제한, API 사용량 추적 등의 기능을 제공합니다.
|
|
*/
|
|
abstract class PublicBaseController extends BaseApiController
|
|
{
|
|
public function __construct()
|
|
{
|
|
// 공개 API는 속도 제한 없음 (무제한 접근 허용)
|
|
}
|
|
|
|
/**
|
|
* 캐시된 응답을 반환하거나 새로 생성합니다.
|
|
*
|
|
* @param string $key 캐시 키
|
|
* @param callable $callback 데이터 생성 콜백
|
|
* @param int $ttl 캐시 유지 시간 (초)
|
|
* @return mixed
|
|
*/
|
|
protected function cached(string $key, callable $callback, int $ttl = 3600)
|
|
{
|
|
return cache()->remember($key, $ttl, $callback);
|
|
}
|
|
|
|
/**
|
|
* API 사용량을 기록합니다.
|
|
*
|
|
* @param string $endpoint 엔드포인트
|
|
* @param array $data 관련 데이터
|
|
* @return void
|
|
*/
|
|
protected function logApiUsage(string $endpoint, array $data = []): void
|
|
{
|
|
// TODO: API 사용량 통계 시스템 구현
|
|
Log::info("Public API Usage: {$endpoint}", [
|
|
'ip' => request()->ip(),
|
|
'user_agent' => request()->userAgent(),
|
|
'data' => $data,
|
|
'timestamp' => now()
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* 클라이언트 정보를 가져옵니다.
|
|
*
|
|
* @return array
|
|
*/
|
|
protected function getClientInfo(): array
|
|
{
|
|
return [
|
|
'ip' => request()->ip(),
|
|
'user_agent' => request()->userAgent(),
|
|
'referer' => request()->header('referer'),
|
|
'timestamp' => now()
|
|
];
|
|
}
|
|
}
|
|
|