การเชื่อมต่อ External APIs

​

ภาพรวม

​

ข้อกำหนดเบื้องต้น

• โปรเจค Stardeck ที่ใช้งานอยู่
• ความคุ้นเคยกับ environment variables ใน Stardeck
• บัญชีกับบริการ API ที่คุณต้องการใช้

​

บริการ API ยอดนิยม

• Payment Gateways: Stripe, Omise, PayPal - ดูคู่มือการเชื่อมต่อการชำระเงินโดยละเอียด
• Weather: OpenWeatherMap, WeatherAPI, Tomorrow.io
• Maps & Location: Google Maps, Mapbox, OpenStreetMap
• Email: SendGrid, Mailgun, Resend
• SMS: Twilio, MessageBird, Vonage
• AI/ML: OpenAI, Anthropic, Google Gemini
• Social Media: Twitter API, Instagram API, LinkedIn API

​

การตั้งค่า OpenWeatherMap (ตัวอย่าง)

​

การสร้างบัญชี

1. ไปที่ openweathermap.org และคลิก Sign In หรือ Sign Up
2. ทำการลงทะเบียนให้เสร็จสมบูรณ์
3. ยืนยันที่อยู่อีเมลของคุณ
4. คุณจะถูกลงทะเบียนใน Free tier โดยอัตโนมัติ

​

การรับ API Key ของคุณ

1. หลังจากเข้าสู่ระบบ ไปที่หน้าบัญชีของคุณโดยคลิกที่ username ของคุณ
2. ไปที่แท็บ API keys
3. คุณจะเห็น API key เริ่มต้นที่สร้างไว้แล้ว หรือคุณสามารถสร้างใหม่ได้
4. คัดลอก API key ของคุณ (เริ่มต้นด้วย string ตัวอักษรและตัวเลขยาว)

​

ทำความเข้าใจขีดจำกัดของ API

• Free tier: 1,000 calls/วัน, 60 calls/นาที
• Data: สภาพอากาศปัจจุบัน, พยากรณ์อากาศ 5 วัน, แผนที่สภาพอากาศ
• Updates: ข้อมูลสภาพอากาศอัปเดตทุก 10 นาที

​

การตั้งค่า APIs ทั่วไปอื่นๆ

​

Google Maps API

1. ไปที่ Google Cloud Console
2. สร้างโปรเจคใหม่หรือเลือกที่มีอยู่
3. เปิดใช้งาน Maps JavaScript API และ Geocoding API
4. ไปที่ Credentials และสร้าง API key
5. จำกัด key โดย HTTP referrer (เพื่อความปลอดภัย)

​

SendGrid (Email)

1. สมัครที่ sendgrid.com
2. ยืนยันที่อยู่อีเมลผู้ส่งของคุณ
3. ไปที่ Settings > API Keys
4. สร้าง API key พร้อมสิทธิ์ที่เหมาะสม
5. คัดลอก key (แสดงเพียงครั้งเดียว)

​

Twilio (SMS)

1. สมัครที่ twilio.com
2. รับหมายเลขโทรศัพท์ทดลองฟรีของคุณ
3. หา Account SID และ Auth Token ของคุณใน dashboard
4. คัดลอกข้อมูลประจำตัวทั้งสอง

​

การกำหนดค่า Environment Variables ใน Stardeck

​

การเพิ่ม API Keys

1. เปิดโปรเจคของคุณใน Stardeck dashboard
2. คลิกปุ่ม Settings (ไอคอนเฟือง)
3. ไปที่แท็บ Environment Variables

​

การกำหนดค่า OpenWeatherMap

​

API Key (Non-Secret)

• Key: WEATHER_API_KEY
• Value: OpenWeatherMap API key ของคุณ
• Secret Variable: Off (ไม่เลือก)
• Deployment Targets: เลือก Sandbox สำหรับการทดสอบ

​

การกำหนดค่า Google Maps

• Key: GOOGLE_MAPS_API_KEY
• Value: Google Maps API key ของคุณ
• Secret Variable: Off (สำหรับการใช้งานฝั่ง client) หรือ On (สำหรับฝั่ง server)
• Deployment Targets: เลือก Sandbox

​

การกำหนดค่า SendGrid

• Key: SENDGRID_API_KEY
• Value: SendGrid API key ของคุณ (เริ่มต้นด้วย SG.)
• Secret Variable: On (เลือก) - เก็บ email API keys เป็น secret เสมอ
• Deployment Targets: เลือก Sandbox

​

การกำหนดค่า Twilio

• Key: TWILIO_ACCOUNT_SID
• Value: Account SID ของคุณ
• Secret Variable: Off
• Key: TWILIO_AUTH_TOKEN
• Value: Auth Token ของคุณ
• Secret Variable: On (เลือก)
• Key: TWILIO_PHONE_NUMBER
• Value: หมายเลขโทรศัพท์ Twilio ของคุณ (เช่น +15551234567)
• Secret Variable: Off

​

การใช้ AI Agent เพื่อสร้างการเชื่อมต่อ API

​

แอปสภาพอากาศพร้อมสภาพปัจจุบัน

Build a weather app that shows current weather for any city.

Requirements:
- Search box where users can enter a city name
- Display current temperature, weather condition, humidity, and wind speed
- Use OpenWeatherMap API with WEATHER_API_KEY environment variable
- Show a weather icon matching the condition
- Handle invalid city names gracefully

​

แดชบอร์ดสภาพอากาศพร้อมพยากรณ์

Create a weather dashboard for my local business showing the 5-day forecast.

Requirements:
- Display weather for my city (Bangkok) automatically
- Show 5-day forecast with daily high/low temperatures
- Use WEATHER_API_KEY to fetch data from OpenWeatherMap
- Update automatically every hour
- Show weather icons for each day

​

บริการตามตำแหน่งพร้อมแผนที่

Add a store locator to my website with an interactive map.

Requirements:
- Display Google Map with markers for my 5 store locations
- Use GOOGLE_MAPS_API_KEY for the map
- Show store details (name, address, hours) when clicking markers
- Add a search box to find nearest store by address
- Mobile-responsive map

​

การแจ้งเตือนทางอีเมล

Send confirmation emails to customers when they submit the contact form.

Requirements:
- Use SendGrid with SENDGRID_API_KEY to send emails
- Email template with our company logo and branding
- Include customer's message and contact details
- Send copy to our support email
- Handle send failures gracefully

​

การแจ้งเตือน SMS

Send SMS notifications to customers when their order is ready for pickup.

Requirements:
- Use Twilio with TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN
- Send SMS from TWILIO_PHONE_NUMBER
- Message format: "Your order #[ORDER_ID] is ready for pickup at [LOCATION]"
- Store SMS delivery status in database
- Only send to valid phone numbers

​

การเชื่อมต่อหลาย API

Build a travel planning tool that combines weather and map data.

Requirements:
- Let users search for a destination
- Show the location on Google Maps using GOOGLE_MAPS_API_KEY
- Display current weather and 5-day forecast using WEATHER_API_KEY
- Show nearby attractions on the map
- Save favorite destinations to database

​

เคล็ดลับสำหรับการใช้ Prompt อย่างมีประสิทธิภาพ

1. ตั้งชื่อ environment variables ให้ชัดเจน - Agent จะใช้พวกเขาโดยอัตโนมัติ
2. ระบุข้อมูลที่จะแสดง - ชัดเจนเกี่ยวกับข้อมูลที่คุณต้องการแสดง
3. กล่าวถึงการจัดการข้อผิดพลาด - APIs สามารถล้มเหลว, timeout, หรือส่งข้อผิดพลาดกลับมา
4. ขอการแคช - พิจารณาขอให้แคช API responses เพื่อประหยัดต้นทุน
5. ระบุความถี่ - ควรรีเฟรชข้อมูลบ่อยแค่ไหน?

​

การทดสอบการเชื่อมต่อของคุณ

​

การทดสอบ Weather API

• เมืองที่ถูกต้อง: ลอง “London” หรือ “Bangkok”
• เมืองที่ไม่ถูกต้อง: ลอง “XYZ123” เพื่อทดสอบการจัดการข้อผิดพลาด
• อักขระพิเศษ: ลอง “São Paulo” เพื่อทดสอบการเข้ารหัส
• ขีดจำกัด rate: ทำ requests หลายๆ ครั้งอย่างรวดเร็วเพื่อทดสอบการจัดการ rate limit

​

การทดสอบ Email/SMS APIs

• ใช้อีเมล/โทรศัพท์ส่วนตัวของคุณในระหว่างการพัฒนา
• ตรวจสอบโฟลเดอร์ spam สำหรับอีเมลทดสอบ
• ตรวจสอบขีดจำกัดการเรียกใช้ API บน dashboard
• ทดสอบกับผู้รับที่ไม่ถูกต้องเพื่อตรวจสอบการจัดการข้อผิดพลาด

​

การตรวจสอบการใช้งาน API

1. ตรวจสอบ dashboard ของผู้ให้บริการ API ของคุณเป็นประจำ
2. ตรวจสอบการใช้งานรายวันเทียบกับขีดจำกัด
3. ตั้งค่าการแจ้งเตือนสำหรับการใช้งานสูง
4. ตรวจสอบ error logs สำหรับ requests ที่ล้มเหลว

​

Best Practices

​

ความปลอดภัย

• ทำเครื่องหมาย keys ที่ละเอียดอ่อนเป็น secret - Email, SMS, และ payment APIs ควรเป็น secret เสมอ
• จำกัด API keys - ใช้การจำกัด HTTP referrer หรือ IP เมื่อมี
• หมุนเวียน keys เป็นประจำ - เปลี่ยน API keys เป็นระยะ
• ห้าม commit keys ไปยัง git - ใช้ environment variables เสมอ

​

ประสิทธิภาพ

• แคช API responses - อย่าดึงข้อมูลเดียวกันซ้ำๆ
• ใช้ rate limiting - เคารพขีดจำกัดของผู้ให้บริการ API
• ใช้ webhooks เมื่อมี - มีประสิทธิภาพมากกว่าการ polling
• จัดการข้อผิดพลาดอย่างเหมาะสม - APIs สามารถไม่พร้อมใช้งานชั่วคราว

​

การจัดการต้นทุน

• ตรวจสอบการใช้งาน - ตรวจสอบ dashboards เป็นประจำ
• ตั้งขีดจำกัดการใช้จ่าย - ใช้การแจ้งเตือนการเรียกเก็บเงิน
• เลือก tier ที่เหมาะสม - อัปเกรดเฉพาะเมื่อจำเป็น
• เพิ่มประสิทธิภาพ requests - ดึงเฉพาะสิ่งที่คุณต้องการ

​

การเผยแพร่ด้วย Production

​

การย้ายไปยัง Production

1. อัปเกรดแผน API หากจำเป็น - ตรวจสอบว่า free tier เพียงพอหรือไม่
2. รับ production API keys - หลายบริการมี prod keys แยกต่างหาก
3. เพิ่ม production environment variables ใน Stardeck
4. ตั้ง Deployment Targets เป็น Production
5. กำหนดค่า webhooks - อัปเดต webhook URLs ไปยังโดเมน production
6. ทดสอบอย่างละเอียด - ตรวจสอบการเชื่อมต่อ API ทั้งหมดทำงานใน production

​

Production Checklist

• ได้รับ production API keys แล้ว
• กำหนดค่าวิธีการเรียกเก็บเงิน/การชำระเงินกับผู้ให้บริการ API
• ตั้งค่าการแจ้งเตือนการใช้งาน
• กำหนดค่า API keys ใน Stardeck production environment
• มีการตรวจสอบข้อผิดพลาดอยู่
• ขีดจำกัด rate เหมาะสมสำหรับ production traffic
• ตรวจสอบ webhook endpoints แล้ว
• เอกสารสำหรับสมาชิกในทีม

​

แหล่งข้อมูลเพิ่มเติม

​

Weather APIs

• OpenWeatherMap Documentation
• WeatherAPI Docs

​

Maps & Location

• Google Maps Platform
• Mapbox Documentation

​

Communication

• SendGrid Documentation
• Twilio Documentation

​

AI & ML

• OpenAI API Documentation
• Anthropic API Documentation