santifer/career-ops · error · Error

rippling: URL must use HTTPS: ${url}

Error message

rippling: URL must use HTTPS: ${url}

What it means

assertRipplingApiUrl rejects any URL whose protocol is not 'https:'. Since rippling builds its API URL from a constant API_BASE that already includes https://, this guard firing means the constant was changed to http or a URL was constructed outside the normal path.

Source

Thrown at providers/rippling.mjs:56

  const segment = parsed.pathname.split('/').filter(Boolean)[0] || '';
  if (!SLUG_RE.test(segment)) return null;
  return segment;
}

/** Build the board API URL for a validated slug. */
function apiUrlForSlug(slug) {
  return `${API_BASE}/${encodeURIComponent(slug)}/jobs`;
}

/** @param {string} url */
function assertRipplingApiUrl(url) {
  let parsed;
  try {
    parsed = new URL(url);
  } catch {
    throw new Error(`rippling: invalid URL: ${url}`);
  }
  if (parsed.protocol !== 'https:') throw new Error(`rippling: URL must use HTTPS: ${url}`);
  if (parsed.hostname !== API_HOST) {
    throw new Error(`rippling: untrusted hostname "${parsed.hostname}" — must be ${API_HOST}`);
  }
  return url;
}

/** @type {Provider} */
export default {
  id: 'rippling',

  detect(entry) {
    const slug = resolveSlug(entry);
    return slug ? { url: apiUrlForSlug(slug) } : null;
  },

  async fetch(entry, ctx) {
    const slug = resolveSlug(entry);
    if (!slug) throw new Error(`rippling: cannot derive API URL for ${entry.name}`);

View on GitHub (pinned to 9b17a8ac97)

Solutions

1. Restore API_BASE to its https:// form.
2. If a URL came from outside, upgrade the scheme: url.replace(/^http:/, 'https:').
3. Audit for any http://api.rippling.com references.

Example fix

// before
const API_BASE = 'http://api.rippling.com/platform/api/ats/v1/board';
// after
const API_BASE = 'https://api.rippling.com/platform/api/ats/v1/board';

function ensureHttps(raw) {
  return typeof raw === 'string' ? raw.replace(/^http:\/\//i, 'https://') : raw;
}
// Pin API_BASE as a non-overridable constant
const API_BASE = 'https://api.rippling.com/platform/api/ats/v1/board';

null

try {
  await provider.fetch(entry, ctx);
} catch (e) {
  if (/must use HTTPS/.test(e.message)) {
    console.error('[bug] rippling API_BASE is http — restore https');
  } else throw e;
}

When it happens

Trigger: API_BASE was set to an http:// scheme; an externally-supplied http URL reached the guard; a test stub passed an http URL.

Common situations: Local development override switched API_BASE to http; a code change or environment variable altered the scheme.

Related errors

• recruitee: URL must use HTTPS: ${url}
• remotli: URL must use HTTPS: ${url}
• rippling: untrusted hostname "${parsed.hostname}" — must be
• smartrecruiters: URL must use HTTPS: ${url}
• a16z-speedrun-talent: URL must use HTTPS: ${url}

AI-assisted analysis of santifer/career-ops@9b17a8ac97 (2026-08-13). Data as JSON: /api/errors/da8cdf19ba3c999f. Report an issue: GitHub.