Referencia de la API central
Los endpoints que el plugin usa para comunicarse con smmkit.app. Útil si estás construyendo una integración propia.
El plugin habla con smmkit.app/api/v1/* usando un JWT de corta duración emitido por POST /api/v1/auth/token. Normalmente nunca necesitas llamar a estos endpoints directamente — el plugin maneja todo el ciclo de vida — pero están documentados aquí por si estás escribiendo tu propia integración.
POST /api/v1/auth/token
Body: { licenseKey }. Devuelve un JWT de 1 hora que autentica las siguientes peticiones vía Authorization: Bearer. Llámalo como máximo una vez por hora — el plugin cachea el resultado en un transient de WP.
POST /api/v1/scan-profile
Body: { platform, handle, variant?, cursor?, siteId? }. Devuelve los datos del perfil en data.body junto con cabeceras de cuota. Es el punto de entrada principal para el selector multi-post.
POST /api/v1/load-more-posts
Igual que scan-profile pero cursor es obligatorio. Usado por el botón "Cargar más" después de la primera página de posts.
POST /api/v1/validate-link y POST /api/v1/validate-post
Validación de URL única usada por los modos frontend simple y preview. Devuelve { valid: true, body: <raw> }.
Envelope de error
Todos los endpoints devuelven { ok: boolean, data | error: { code, message } }. Los códigos de error son estables y documentados — el plugin los mapea a mensajes amigables en friendly_error_for_code().