be' Ping Service - API Documentation

🚀

Fast & Reliable

Lightning-fast response times with built-in error handling and validation

🌍

UTF-8 Support

Full Unicode support including Turkish, Chinese, Arabic and all international characters

🛡️

Rate Limited

Built-in spam protection with IP-based rate limiting and URL validation

📊

XML-RPC Compatible

Standard XML-RPC response format compatible with all major blog platforms

API Endpoint

GET http://rpc.blogexp.com/ping.php

Parameters

Parameter	Type	Required	Description
name	String	Required	Blog or website name (max 200 characters, UTF-8 supported)
url	URL	Required	Blog or website URL (must be HTTP/HTTPS)

Usage Examples

📄 Direct Browser Request

http://rpc.blogexp.com/ping.php?name=My Blog&url=https://myblog.com

💻 cURL Command

curl "http://rpc.blogexp.com/ping.php?name=My Blog&url=https://myblog.com"

🔒 cURL with URL Encoding

curl -G "http://rpc.blogexp.com/ping.php" --data-urlencode "name=My Blog" --data-urlencode "url=https://myblog.com"

🌍 International Characters

curl "http://rpc.blogexp.com/ping.php?name=Şerif Güngör Blog&url=https://serifgungor.com"

🔗 JavaScript Fetch

fetch('http://rpc.blogexp.com/ping.php?name=My Blog&url=https://myblog.com')

🐍 Python Requests

requests.get('http://rpc.blogexp.com/ping.php', params={'name': 'My Blog', 'url': 'https://myblog.com'})

Response Format

All responses are returned in XML-RPC format with UTF-8 encoding.

✅ Success Response

<?xml version="1.0" encoding="UTF-8"?>
<methodResponse>
  <params>
    <param>
      <value><string>Blog ping başarıyla kaydedildi: My Awesome Blog (https://myblog.com)</string></value>
    </param>
  </params>
</methodResponse>

❌ Error Response

<?xml version="1.0" encoding="UTF-8"?>
<methodResponse>
  <fault>
    <value>
      <struct>
        <member>
          <name>faultCode</name>
          <value><int>400</int></value>
        </member>
        <member>
          <name>faultString</name>
          <value><string>Blog adı boş olamaz veya 200 karakterden uzun olamaz.</string></value>
        </member>
      </struct>
    </value>
  </fault>
</methodResponse>

Status Codes

200 - Success
Ping recorded successfully

400 - Bad Request
Missing or invalid parameters

429 - Too Many Requests
Rate limit exceeded (10/hour per IP)

500 - Server Error
Internal server error

Common Error Responses

🚫 Missing Parameters

<?xml version="1.0" encoding="UTF-8"?>
<methodResponse>
  <fault>
    <value>
      <struct>
        <member>
          <name>faultCode</name>
          <value><int>400</int></value>
        </member>
        <member>
          <name>faultString</name>
          <value><string>Eksik parametreler. name ve url parametreleri gereklidir.</string></value>
        </member>
      </struct>
    </value>
  </fault>
</methodResponse>

⏰ Rate Limit Exceeded

<?xml version="1.0" encoding="UTF-8"?>
<methodResponse>
  <fault>
    <value>
      <struct>
        <member>
          <name>faultCode</name>
          <value><int>429</int></value>
        </member>
        <member>
          <name>faultString</name>
          <value><string>Çok fazla istek. Saatte maksimum 10 ping gönderebilirsiniz.</string></value>
        </member>
      </struct>
    </value>
  </fault>
</methodResponse>

🔗 Invalid URL

<?xml version="1.0" encoding="UTF-8"?>
<methodResponse>
  <fault>
    <value>
      <struct>
        <member>
          <name>faultCode</name>
          <value><int>400</int></value>
        </member>
        <member>
          <name>faultString</name>
          <value><string>Geçersiz URL formatı veya engellenmiş URL.</string></value>
        </member>
      </struct>
    </value>
  </fault>
</methodResponse>

🌐 URL Not Accessible

<?xml version="1.0" encoding="UTF-8"?>
<methodResponse>
  <fault>
    <value>
      <struct>
        <member>
          <name>faultCode</name>
          <value><int>404</int></value>
        </member>
        <member>
          <name>faultString</name>
          <value><string>Blog URL'sine erişilemiyor. Lütfen URL'nin doğru ve erişilebilir olduğundan emin olun.</string></value>
        </member>
      </struct>
    </value>
  </fault>
</methodResponse>

Rate Limiting & Security

🔒 Security Features

Rate Limiting: Maximum 10 pings per hour per IP address
URL Validation: Only HTTP/HTTPS URLs are accepted
Private IP Blocking: Localhost and private networks are blocked
Duplicate Prevention: Same URL can only ping once per hour
URL Accessibility Check: Verifies that the blog URL is accessible
Character Limit: Blog names limited to 200 characters

📊 Logging

All ping requests are logged with the following information:

Timestamp
Blog name and URL
Client IP address
User agent
HTTP referer (if available)

Integration Examples

🔌 WordPress Integration

Add this endpoint to your WordPress ping services list:

Settings → Writing → Update Services:
http://rpc.blogexp.com/ping.php

📝 Manual PHP Integration

<?php
$ping_url = 'http://rpc.blogexp.com/ping.php';
$blog_name = 'My Awesome Blog';
$blog_url = 'https://myblog.com';

$url = $ping_url . '?' . http_build_query([
    'name' => $blog_name,
    'url' => $blog_url
]);

$response = file_get_contents($url);
echo $response;
?>

🔄 Node.js Integration

const fetch = require('node-fetch');

const pingBlog = async (name, url) => {
    const pingUrl = `http://rpc.blogexp.com/ping.php?name=${encodeURIComponent(name)}&url=${encodeURIComponent(url)}`;
    
    try {
        const response = await fetch(pingUrl);
        const xml = await response.text();
        console.log(xml);
    } catch (error) {
        console.error('Ping failed:', error);
    }
};

pingBlog('My Blog', 'https://myblog.com');

🚀 Try It Now!

Test the API with our interactive tools

API Endpoint

📡 Blog Ping Service - Simple, Fast, Reliable

Compatible with Blogexp, WordPress, Blogger, and all major blogging platforms

Supports UTF-8, Rate Limited, XML-RPC Compatible