Habait Hayehudi API & documentation

Habait Hayehudi is a Jewish shidduch (matchmaking) website. Its public content is exposed read-only through a REST API (Supabase PostgREST) described in /openapi.json (OpenAPI 3.1).

Authentication

Send the public anon key (the same one the website uses, found in the site's JavaScript bundle) in the apikey header. Row-level security restricts anonymous access to published, public rows. The documented API is read-only and there is no API key signup: candidate registrations are made through the website form at /inscricao.

Endpoints

Example

curl -H "apikey: <anon key>" "https://bbhscnpjcwksqpcolglc.supabase.co/rest/v1/parcerias?select=nome,cidade,desconto&order=ordem"

Scopes

Operations declare least-privilege scopes: read:blog and read:partnerships (see protected resource metadata).

Versioning and deprecation

The API is versioned in the URL (/rest/v1). Breaking changes ship under a new version path; the previous version keeps working for at least 90 days after the change is announced on this page and in llms.txt. Deprecated versions are marked here and, where the host supports it, with Deprecation and Sunset headers.

Errors

Unknown paths return a real HTTP 404. This site's own paths return JSON errors of the form {"error":{"code","message","resolution"}}. Rate limits are those of the underlying Supabase project; honor Retry-After on HTTP 429.

See also: llms.txt · sitemap · About · Contact · Privacy