ข้อกำหนดการเชื่อมต่อข้อมูลสถานีStation Data Integration Specification

• อ่านอย่างเดียว ไม่มีการเขียนกลับเข้าระบบ CPO
• ไม่สั่งเริ่ม/หยุดชาร์จ ไม่จองหัว ไม่รับชำระเงิน
• ไม่ส่งข้อมูลที่ระบุตัวผู้ใช้ปลายทางให้ CPO

• Read-only. Nothing is ever written back into the CPO’s system.
• No remote start/stop, no reservations, no payment.
• Nothing that identifies an end user is ever sent to the CPO.

ตู้ DC ที่มีทั้ง CCS2 และ CHAdeMO = 1 EVSE, 2 Connector เพราะเสียบได้ทีละหัว สถานะจึงมีค่าเดียว

A DC unit with both CCS2 and CHAdeMO is 1 EVSE and 2 connectors — only one can be in use at a time, so there is a single status.

1. นอกระบบCPO ส่ง TOKEN_A ให้เรา ใช้ลงทะเบียนได้ครั้งเดียว
2. PugEV → CPOเราถามว่ารองรับเวอร์ชันไหน แล้วรับรายการ endpoint ทั้งหมดจากคำตอบ ไม่มี URL ไหน hardcode

   GET /ocpi/versions
   Authorization: Token <TOKEN_A>
   
   200 OK
   {
     "data": [
       {
         "version": "2.2.1",
         "url": ".../ocpi/2.2.1"
       }
     ],
     "status_code": 1000
   }

3. PugEV → CPOเราส่ง TOKEN_C ที่ออกให้ CPO พร้อม URL versions ของเรา

   POST /ocpi/2.2.1/credentials
   Authorization: Token <TOKEN_A>
   
   {
     "token": "<TOKEN_C>",
     "url": "https://.../ocpi/versions",
     "roles": [
       {
         "role": "EMSP",
         "country_code": "TH",
         "party_id": "..."
       }
     ]
   }

4. CPO → PugEVCPO เรียก versions ของเราด้วย TOKEN_C เพื่อยืนยันว่าปลายทางเปิดอยู่จริง — ขั้นนี้พังบ่อยที่สุด
5. CPO → PugEVตอบ 200 พร้อม TOKEN_B แล้ว TOKEN_A หมดอายุทันที สายเปิดใช้งาน

รองรับ 2.2.1 เป็นหลักและ 2.1.1 สำหรับระบบเดิม ส่วน 2.3.0 ยังไม่รองรับ แจ้งเราได้ถ้ามีเฉพาะเวอร์ชันนี้

1. Out of bandThe CPO sends us TOKEN_A. Valid for one registration.
2. PugEV → CPOWe ask which versions the CPO speaks and take the whole endpoint list from the answer. No URL is hardcoded.

   GET /ocpi/versions
   Authorization: Token <TOKEN_A>
   
   200 OK
   {
     "data": [
       {
         "version": "2.2.1",
         "url": ".../ocpi/2.2.1"
       }
     ],
     "status_code": 1000
   }

3. PugEV → CPOWe send TOKEN_C — the token we issue to the CPO — plus our own versions URL.

   POST /ocpi/2.2.1/credentials
   Authorization: Token <TOKEN_A>
   
   {
     "token": "<TOKEN_C>",
     "url": "https://.../ocpi/versions",
     "roles": [
       {
         "role": "EMSP",
         "country_code": "TH",
         "party_id": "..."
       }
     ]
   }

4. CPO → PugEVThe CPO calls our versions endpoint with TOKEN_C to confirm the far end is really live. This is the step that fails most often.
5. CPO → PugEVReply 200 with TOKEN_B. TOKEN_A expires immediately and the link is live.

2.2.1 is the target and 2.1.1 is supported for older stacks. 2.3.0 is not supported yet — tell us if it is all the platform runs.

• HTTPS TLS 1.2 ขึ้นไป ใบรับรองต้องตรวจสอบได้ เราไม่ปิดการตรวจไม่ว่ากรณีใด
• โทเคนเก็บใน secret store แยกจากฐานข้อมูล หมุนเวียนได้ แจ้งล่วงหน้า 7 วัน
• ต้องการ IP allowlist แจ้งได้ เรามีชุด IP ขาออกคงที่
• เราจำกัดอัตราการเรียกฝั่งเราเอง และเคารพ 429 พร้อม Retry-After ของ CPO
• ไม่มีข้อมูลผู้ใช้ปลายทางไหลไปหา CPO และเราไม่รับข้อมูลลูกค้าของ CPO

โทเคนรั่วหรือเห็นทราฟฟิกผิดปกติ แจ้ง [email protected] เราเพิกถอนภายใน 24 ชั่วโมงและออกชุดใหม่ให้

• HTTPS, TLS 1.2 or later, verifiable certificate. We never disable validation, for any reason.
• Tokens live in a secret store separate from the database and rotate on the CPO’s schedule with 7 days’ notice.
• Want an IP allowlist? Ask — we have fixed egress addresses.
• We rate-limit ourselves outbound and honour the CPO’s 429 and Retry-After.
• No end-user data reaches the CPO, and we neither ask for nor accept its customer data.

If a token is exposed or unexpected traffic shows up, write to [email protected]. We revoke within 24 hours and issue replacements.