connections

GET /v1/connections/providers

Every provider a customer can connect, with its form and its checklist.

כל נקודות הקצה מסוג connections

כל תיעוד המפתחים

אימות

שלח מפתח API כטוקן Bearer. נקודת קצה זו אינה מציינת הרשאת ספציפית במפרט, לכן הקצה למפתח שלך את המינימום הנדרש ובדוק את התגובה במקום להניח הנחות.

נקודת קצה זו אינה דורשת מזהה ארגון. המפתח שלך כבר מזהה את הארגון שאליו הוא שייך, והתגובה מוגבלת אליו בלבד.

נסה זאת

החלף כל דבר בסוגריים זוויתיים בערכים משלך, ואת מציין מיקום המפתח במפתח מלוח הבקרה שלך.

curl -X GET https://api.zinndigital.com/v1/connections/providers \
  -H "Authorization: Bearer zdk_live_…"

מחובר? קונסולת ה-API בלוח הבקרה שלך מזינה את מזהה הארגון האמיתי שלך ואת המפתח שלך, ומריצה את הבקשה מול ה-API הפיזי כך שתוכל לראות את התגובה בפועל. פתח נקודת קצה זו במסוף ה-API

פרטים

The catalogue: for each connectable provider, which credential fields it takes (and which of them are secret), and which permissions we will test it for. Served as an endpoint rather than baked into each client because the six BYO DNS vendors take credentials of one, two and five fields — ClouDNS needs auth_id and auth_password, Azure needs five — and hardcoding those in a client duplicates the driver's own required_settings across the wire, where the two copies are free to drift apart. Every field name here is read off the driver class itself, so a vendor that gains a required setting changes this response and cannot be connected with a bundle it will refuse. shapes is a list of alternative credential forms; a client renders the first and offers the rest. Cloudflare is the live case: a scoped API token, or the account email plus its Global API Key. permissions is empty when we have no permission model for that provider. ⛔ Render that as "we cannot test this provider's permissions" — never as a satisfied (empty) checklist, which is a different and wrong claim. Requires authentication only; it describes what can be connected, not what anyone has connected.

תשובה

שםסוגנדרשמה זה
dataConnectionProviderDescriptor[]כן

שגיאות שנקודה קצה זו עשויה להחזיר

401 · 429