Platform API ref follow-on updates, part 1 #404
Merged
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There were several errors in the Platform API reference docs that I just published, now that I'm able to actually fully test the production endpoints. The biggest ones in this first follow-on PR are:
https://
instead ofhttp://
. Switching from HTTP to HTTPS was a relatively last-minute back-end update. In the meantime, our more tech-savvy customers should be able to figure this out.name
andtype
should not be specified. In the meantime, customers might be able to figure this out by cross-referencing the Swagger UI, but this is certainly not intuitive.(The second follow-on PR, of a slightly lower priority, is to backfill instructions for creating some of the source and destination connectors that are missing, as these connectors were brought online just a few days ago. The field names for these connectors do not match 1:1 with the related labels in the UI, and they are not exposed in the Swagger UI either, so without these docs it will be almost impossible to figure them out. These are; sources: Couchbase, Dropbox, Elasticsearch, Google Drive, and Salesforce; and destinations: Destinations: Couchbase, PostgreSQL, and Qdrant.)