Documentation for the /sql API endpoint
Hi
I was wondering if there was any doco available for the /sql endpoint?
Also, has there been any movement since earlier in the year around a serverless driver for Java?
It would be great to get an idea of the roadmap for the neon sql api so I can lock in some architecture decisions in consuming it.
Thanks!
Ben
6 Replies
optimistic-gold•12mo ago
Hi Ben
There's no docs available for it
You can reverse-engineer it from the Node.js implementation
https://github.com/neondatabase/serverless/blob/main/export/httpQuery.ts
We have no roadmap for a Java serverless driver, but it's not that complicated for someone to contribute it externally
foreign-sapphireOP•12mo ago
Thanks @David Gomes - will the query endpoint be supported strategically as part of the Neon API roadmap do you think?
other-emerald•12mo ago
Although worth pointing out that the API is not considered stable. There's some breaking changes to the API up for consideration at the moment that we will backport to the serverless driver and potentially phase out the legacy support over time
(currently there's conversations about replacing JSON with CBOR for better support for binary data types among other things)
optimistic-gold•12mo ago
Yes but possibly there will be breaking changes to it or we'll do a
/v2/sql.other-emerald•12mo ago
I think we'll more likely make use of Accept/Content-Type headers, so there won't be any hard breakage like that
foreign-sapphireOP•11mo ago
Hi @Conrad Ludgate, what do you mean by "potentially phase out the legacy support over time" - are you referring to the serverless JS driver?