워드프레스 REST API를 활용하여 사이트 확장하기

워드프레스 REST API는 사이트를 외부 애플리케이션과 연동할 수 있도록 지원하는 강력한 기능입니다. 이를 통해 데이터를 자유롭게 가져오고 조작할 수 있으며, 커스터마이징을 통해 다양한 기능을 추가할 수 있습니다. REST API를 활용하면 모바일 앱, SaaS 플랫폼, 기타 웹사이트와 워드프레스를 연동하는 것이 가능합니다. 본 글에서는 REST API의 기본 개념부터 고급 활용 방법, 보안 및 커스터마이징 기법까지 상세하게 다루겠습니다.

1. 워드프레스 REST API란?

워드프레스 REST API는 JSON(JavaScript Object Notation) 형식으로 데이터를 송수신하는 기능을 제공합니다. 기본적으로 모든 워드프레스 사이트는 /wp-json/wp/v2/ 엔드포인트를 통해 API를 제공합니다. 예를 들어, 모든 게시물을 가져오려면 다음과 같은 요청을 보낼 수 있습니다.

GET https://example.com/wp-json/wp/v2/posts

이 API는 워드프레스 코어와 연동되는 기본 기능을 제공하며, 커스터마이징을 통해 확장할 수도 있습니다.

2. REST API의 기본 기능 및 활용

게시물 및 페이지 데이터 가져오기

전체 게시물 조회

REST API를 사용하여 모든 게시물을 가져오려면 다음과 같은 요청을 보낼 수 있습니다.

GET https://example.com/wp-json/wp/v2/posts

특정 카테고리의 게시물 조회

특정 카테고리에 속한 게시물을 가져오려면 다음과 같은 요청을 보낼 수 있습니다.

GET https://example.com/wp-json/wp/v2/posts?categories=3

단일 게시물 조회

특정 게시물을 가져오려면 게시물 ID를 포함하여 요청해야 합니다.

GET https://example.com/wp-json/wp/v2/posts/123

REST API를 활용하면 게시물, 페이지, 사용자 등의 데이터를 쉽게 가져올 수 있습니다. 예를 들어, 특정 카테고리의 게시물을 가져오려면 다음과 같이 요청할 수 있습니다.

GET https://example.com/wp-json/wp/v2/posts?categories=3

여기서 categories=3은 특정 카테고리 ID에 해당하는 게시물만 반환하는 역할을 합니다.

사용자 인증 및 보안 설정

워드프레스 REST API는 기본적으로 공개 데이터(게시물, 카테고리 등)는 인증 없이 제공하지만, 사용자 정보나 게시물 수정과 같은 작업은 인증이 필요합니다. 워드프레스는 여러 가지 인증 방식을 제공하며, 보안을 강화하기 위해 SSL 적용이 필수적입니다.

• OAuth 인증: 외부 애플리케이션이 사용자 권한을 요청할 때 사용됩니다.
• JWT(JSON Web Token) 인증: API 호출 시 토큰을 사용하여 인증을 수행합니다.
• 쿠키 인증: 워드프레스 내에서 AJAX 호출을 수행할 때 사용됩니다.

3. 커스텀 REST API 엔드포인트 추가하기

워드프레스 REST API의 기본 기능 외에도, 개발자는 새로운 엔드포인트를 추가하여 커스터마이징할 수 있습니다. 예를 들어, 특정 사용자 ID의 주문 목록을 반환하는 API를 만들려면 다음과 같이 functions.php에 코드를 추가할 수 있습니다.

add_action('rest_api_init', function () {
    register_rest_route('custom/v1', '/orders/(?P<user_id>\d+)', array(
        'methods' => 'GET',
        'callback' => 'get_user_orders',
    ));
});

function get_user_orders($data) {
    $user_id = $data['user_id'];
    $orders = get_posts(array(
        'post_type' => 'shop_order',
        'author' => $user_id
    ));
    return $orders;
}

이렇게 하면 /wp-json/custom/v1/orders/{user_id}를 호출하여 특정 사용자의 주문 목록을 가져올 수 있습니다.

4. REST API 보안 강화 방법

REST API를 사용할 때 보안 설정이 중요합니다. 다음과 같은 보안 조치를 고려해야 합니다.

• SSL/TLS 활성화: API 요청과 응답을 암호화하여 보안성을 강화합니다.
• 인증 토큰 사용: JWT 또는 OAuth를 사용하여 인증을 수행합니다.
• 비공개 데이터 제한: 중요한 데이터는 capabilities 또는 permission_callback을 설정하여 보호합니다.
• CORS 설정: API 요청을 허용할 도메인을 지정하여 악의적인 요청을 차단합니다.

5. REST API 활용 사례

활용 사례	설명
모바일 앱 연동	워드프레스 REST API를 사용하여 모바일 애플리케이션과 동기화할 수 있습니다.
커스텀 대시보드 제작	관리자 패널 외에 맞춤형 대시보드를 생성할 수 있습니다.
외부 시스템 통합	CRM, ERP, 이메일 마케팅 툴과 연동하여 데이터를 활용할 수 있습니다.

6. FAQ

Q 워드프레스 REST API에서 CORS 오류를 해결하는 방법은?

CORS 오류는 기본적으로 보안 조치로 인해 발생합니다. 해결하려면 functions.php 파일에서 header("Access-Control-Allow-Origin: *");를 추가하거나, rest_pre_serve_request 필터를 사용하여 특정 도메인만 허용하도록 설정해야 합니다. 또한 서버의 .htaccess 파일을 수정하여 Header set Access-Control-Allow-Origin "*" 설정을 적용할 수도 있습니다.

Q REST API에서 사용자 데이터를 보호하는 방법은?

REST API에서 사용자 데이터를 보호하려면 인증 방식을 적용하는 것이 필수적입니다. JWT, OAuth 또는 기본 워드프레스의 인증 시스템을 활용하여 API 요청이 인증된 사용자만 접근하도록 설정하는 것이 좋습니다. 또한 permission_callback을 활용하여 특정 사용자 권한을 가진 경우에만 데이터에 접근할 수 있도록 제한해야 합니다.

Q REST API 속도를 최적화하는 방법은?

REST API의 성능을 향상시키려면 데이터 캐싱을 활용하는 것이 중요합니다. WP REST Cache 플러그인을 사용하면 API 응답을 캐싱할 수 있으며, 불필요한 API 호출을 줄일 수 있습니다. 또한 요청 시 불필요한 필드를 제외하여 데이터 패킷 크기를 줄이는 것도 효과적인 방법입니다.

Q REST API 요청에서 특정 필드만 반환하려면?

REST API 요청 시 ?_fields=title,content 파라미터를 추가하면 특정 필드만 반환할 수 있습니다. 이렇게 하면 불필요한 데이터를 제외하고 필요한 데이터만 받을 수 있어 API 성능을 최적화하는 데 도움이 됩니다.

Q REST API를 사용하여 외부 애플리케이션과 데이터를 동기화할 수 있나요?

네, REST API를 활용하면 외부 애플리케이션과 데이터를 실시간으로 동기화할 수 있습니다. 예를 들어, ERP 시스템과 연동하여 주문 정보를 자동으로 업데이트하거나, 모바일 앱과 연동하여 최신 게시물을 동기화할 수 있습니다.