优化博客 API 集成：Dev.to 和 Hashnode 的经验教训

在 Astro 开发我的个人作品集期间，我遇到了一个有趣的挑战：如何有效地集成我的 Dev.to 和 Hashnode 帖子，而不必每次发帖时都重建网站新内容？

问题

问题一开始似乎很简单：在一个页面上显示我来自两个平台的所有帖子。然而，我遇到了一些挑战：

1. 分页限制：最初，我只收到前 20-30 个帖子
2. 丢失的帖子：每次我发布新帖子时，我都必须修改代码才能使其显示
3. 激进的缓存：由于缓存，新帖子没有立即出现

解决方案

1.无服务器端点

我在 Astro 中创建了一个无服务器端点，它结合了两个平台的帖子：

export const GET: APIRoute = async () => {
  const [hashnodePosts, devtoPosts] = await Promise.all([
    getHashnodePosts(),
    getDevToPosts()
  ]);

  const allPosts = [...hashnodePosts, ...devtoPosts]
    .sort((a, b) => 
      new Date(b.rawDate).getTime() - new Date(a.rawDate).getTime()
    );

  return new Response(JSON.stringify(allPosts), {
    headers: {
      'Content-Type': 'application/json',
      'Cache-Control': 'no-store, no-cache, must-revalidate'
    }
  });
};

2. 岗位收益最大化

关键是请求尽可能多的帖子数：

// Para Dev.to
const params = new URLSearchParams({
  username: 'goaqidev',
  per_page: '1000', // Máximo número de posts
  state: 'published'
});

// Para Hashnode
const query = `
  query {
    publication(host: "goaqidev.hashnode.dev") {
      posts(first: 1000) { // Máximo número de posts
        edges {
          node {
            title
            brief
            // ...otros campos
          }
        }
      }
    }
  }
`;

3. 避免缓存

为了确保内容新鲜，我实施了反缓存策略：

const timestamp = new Date().getTime();
const response = await fetch(`/api/posts.json?_=${timestamp}`, {
  headers: {
    'Cache-Control': 'no-cache',
    'Pragma': 'no-cache'
  }
});

4. 客户端实现

为了保持界面最新，我创建了一个 React 组件来处理加载和更新帖子：

import { useState, useEffect } from 'react';

function BlogPosts() {
  const [posts, setPosts] = useState([]);
  const [loading, setLoading] = useState(true);

  useEffect(() => {
    const fetchPosts = async () => {
      try {
        const timestamp = new Date().getTime();
        const response = await fetch(`/api/posts.json?_=${timestamp}`);
        const data = await response.json();
        setPosts(data);
      } catch (error) {
        console.error('Error fetching posts:', error);
      } finally {
        setLoading(false);
      }
    };

    fetchPosts();
    // Actualizar cada 5 minutos
    const interval = setInterval(fetchPosts, 5 * 60 * 1000);
    return () => clearInterval(interval);
  }, []);

  if (loading) return <div>Cargando posts...</div>;

  return (
    <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4">
      {posts.map(post => (
        <article key={post.id} className="card">
          <h2>{post.title}</h2>
          <p>{post.brief}</p>
          <a href={post.url}>Leer más</a>
        </article>
      ))}
    </div>
  );
}

获得的好处

1. 自动更新：新帖子出现，无需重建网站
2. 更好的性能：由于无服务器端点，初始加载速度更快
3. 无内容丢失：所有帖子都可以访问，无论何时发布
4. 减少维护：无需手动干预即可显示新帖子

错误处理

我实现了一个强大的错误处理系统：

async function fetchPosts() {
  try {
    const response = await fetch('/api/posts.json');
    if (!response.ok) {
      throw new Error(`HTTP error! status: ${response.status}`);
    }
    const posts = await response.json();
    return posts;
  } catch (error) {
    console.error('Error fetching posts:', error);
    // Intentar cargar desde caché local si está disponible
    const cachedPosts = localStorage.getItem('blog_posts');
    return cachedPosts ? JSON.parse(cachedPosts) : [];
  }
}

性能优化

为了进一步提高性能，我实施了：

1. 本地缓存：

// Guardar posts en localStorage
localStorage.setItem('blog_posts', JSON.stringify(posts));

// Cargar posts desde localStorage mientras se actualiza
const cachedPosts = localStorage.getItem('blog_posts');
if (cachedPosts) {
  setPosts(JSON.parse(cachedPosts));
}

1. 图像延迟加载：

function PostImage({ src, alt }) {
  return (
    <img 
      loading="lazy"
      src={src} 
      alt={alt}
      className="w-full h-48 object-cover"
    />
  );
}

该解决方案已被证明是稳健且高效的，使我能够：

• 自动更新我的投资组合
• 通过快速充电改善用户体验
• 减少手动维护的需要
• 确保我的所有内容均可用且是最新的

下一步

我计划实施：

1. 帖子搜索和过滤系统
2. 内容预览
3. 参与度指标
4. 统一评论系统

以上是优化博客 API 集成：Dev.to 和 Hashnode 的经验教训的详细内容。更多信息请关注PHP中文网其他相关文章！