API

Añade una ficha con una sola petición

Sin clave, sin registro y sin entorno de pruebas. Si eres una persona, el formulario es más rápido. Si eres un script o un asistente haciendo esto por alguien, manda el JSON aquí.

Da estas instrucciones a tu asistente

Incluye mi producto en Best of Its Class. Lee primero https://bestofitsclass.com/api/v1/. Elige la categoría más adecuada de https://bestofitsclass.com/api/v1/categories/. Después haz un POST a https://bestofitsclass.com/api/v1/entries/ con estos datos:
- nombre: [NOMBRE DEL PRODUCTO]
- sitio web: [SITIO WEB DEL PRODUCTO]
- correo: [CORREO DE CONTACTO]
Incluye el slug de la categoría y evidence_url si los tienes. Incluye una breve descripción si resulta útil. No inventes pruebas, puestos, reseñas ni verificaciones. Dime la respuesta y el id de la propuesta.

Añadir una ficha

curl -X POST https://bestofitsclass.com/api/v1/entries/ \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Tracker",
    "website": "https://acme.example",
    "email": "[email protected]",
    "category": "portfolio-trackers",
    "evidence_url": "https://acme.example/pricing",
    "pitch": "Tracks bonds and options, not just equities."
  }'

Solo name, website y email son obligatorios. Omite category y la colocamos nosotros. evidence_url es lo que convierte una ficha en un puesto de la lista, así que mándalo si lo tienes, pero nada se rechaza por no llevarlo.

Buscar una categoría

curl https://bestofitsclass.com/api/v1/categories/

Devuelve todas las categorías publicadas con su slug, los puntos que miramos y qué pruebas ayudan. /api/v1/ describe la API entera igual.

Los detalles

20 fichas por hora y 60 al día, por IP.
Mandar dos veces la misma web devuelve la primera ficha en vez de crear otra.
Success is 201 with the entry id. Problems come back as {"ok": false, "error": "..."} with a readable message.
La revisión es automática y suele tardar menos de una hora. Las fichas aceptadas aparecen en su página de categoría.