چرا داده‌های شما به API خارجی نمی‌رسد؟ راهنمای تخصصی wp_remote_post

چرا ارسال POST به API حیاتی است؟

تابع wp_remote_post چیست؟

امضای تابع و پارامترها

function wp_remote_post( $url, $args = array() ) {
    $http = _wp_http_get_object();
    return $http->request( $url, $args );
}

آرگومان‌های کلیدی args

$response = wp_remote_post(
    'https://api.example.com/v1/orders',
    array(
        'timeout'     => 20,
        'headers'     => array(
            'Authorization' => 'Bearer ' . $api_token,
            'Content-Type'  => 'application/json',
            'Accept'        => 'application/json',
        ),
        'body'        => wp_json_encode( array(
            'customer_id' => $customer_id,
            'total'       => $order_total,
            'items'       => $order_items,
        ) ),
        'data_format' => 'body',
        'sslverify'   => true,
    )
);

ساختار body و انواع محتوا

$response = wp_remote_post( $url, array(
    'body' => array(
        'name'  => 'علی',
        'email' => 'ali@example.com',
    ),
) );

$response = wp_remote_post( $url, array(
    'headers'     => array( 'Content-Type' => 'application/json' ),
    'body'        => wp_json_encode( $payload ),
    'data_format' => 'body',
) );

$response = wp_remote_post( $url, array(
    'body' => array(
        'file' => file_get_contents( $file_path ),
        'name' => 'document.pdf',
    ),
) );

هدرهای احراز هویت

'headers' => array(
    'Authorization' => 'Bearer ' . $token,
),

'headers' => array(
    'Authorization' => 'Basic ' . base64_encode( $username . ':' . $password ),
),

'headers' => array(
    'X-API-Key' => $api_key,
),

بررسی is_wp_error

$response = wp_remote_post( $url, $args );

if ( is_wp_error( $response ) ) {
    error_log( 'API request failed: ' . $response->get_error_message() );
    return false;
}

$status = wp_remote_retrieve_response_code( $response );
if ( $status >= 400 ) {
    $body = wp_remote_retrieve_body( $response );
    $error_data = json_decode( $body, true );

    error_log( sprintf(
        'API returned error %d: %s',
        $status,
        isset( $error_data['message'] ) ? $error_data['message'] : 'Unknown error'
    ) );

    return false;
}

$body = wp_remote_retrieve_body( $response );
$data = json_decode( $body, true );

return $data;

کاربردهای عملی در افزونه

function myplugin_sync_order_to_warehouse( $order_id ) {
    $order = wc_get_order( $order_id );
    if ( ! $order ) {
        return false;
    }

    $payload = array(
        'order_id'     => $order_id,
        'customer'     => array(
            'name'  => $order->get_billing_first_name() . ' ' . $order->get_billing_last_name(),
            'email' => $order->get_billing_email(),
        ),
        'items'        => array(),
        'total'        => $order->get_total(),
        'created_at'   => $order->get_date_created()->format( 'c' ),
    );

    foreach ( $order->get_items() as $item ) {
        $payload['items'][] = array(
            'sku'      => $item->get_product()->get_sku(),
            'quantity' => $item->get_quantity(),
            'price'    => $item->get_total(),
        );
    }

    $response = wp_remote_post(
        'https://warehouse.example.com/api/orders',
        array(
            'timeout'     => 30,
            'headers'     => array(
                'Authorization' => 'Bearer ' . get_option( 'myplugin_warehouse_token' ),
                'Content-Type'  => 'application/json',
            ),
            'body'        => wp_json_encode( $payload ),
            'data_format' => 'body',
        )
    );

    if ( is_wp_error( $response ) ) {
        update_post_meta( $order_id, '_warehouse_sync_status', 'failed' );
        return false;
    }

    $status = wp_remote_retrieve_response_code( $response );
    if ( 200 !== $status && 201 !== $status ) {
        update_post_meta( $order_id, '_warehouse_sync_status', 'failed' );
        return false;
    }

    update_post_meta( $order_id, '_warehouse_sync_status', 'success' );
    return true;
}

function myplugin_send_sms( $phone, $message ) {
    $response = wp_remote_post(
        'https://api.sms-provider.com/v1/send',
        array(
            'timeout' => 10,
            'headers' => array(
                'Authorization' => 'Bearer ' . get_option( 'myplugin_sms_token' ),
            ),
            'body'    => array(
                'to'      => $phone,
                'message' => $message,
            ),
        )
    );

    if ( is_wp_error( $response ) ) {
        return false;
    }

    return 200 === wp_remote_retrieve_response_code( $response );
}

استراتژی Retry و پایداری

function myplugin_api_post_with_retry( $url, $args, $max_retries = 3 ) {
    $attempt = 0;

    while ( $attempt < $max_retries ) {
        $response = wp_remote_post( $url, $args );

        if ( ! is_wp_error( $response ) ) {
            $status = wp_remote_retrieve_response_code( $response );
            if ( $status < 500 ) {
                return $response;
            }
        }

        $attempt++;

        if ( $attempt < $max_retries ) {
            $delay = pow( 2, $attempt );
            sleep( $delay );
        }
    }

    return new WP_Error( 'api_max_retries', 'API request failed after retries' );
}

نکات امنیتی و اشتباهات رایج

تحلیل فنی پیشرفته

پرسش‌های پرتکرار

نتیجه و مسیر ادامه